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Introduction 



This Reference Guide can be used to help you perform the following tasks in 
ObjectWindows: 

■ Look up the overall purpose for each class. 

■ Learn the details about how to use a particular ObjectWindows class and 
its members and functions. 

■ View the virtual and nonvirtual multiple inheritance relationships 
among ObjectWindows classes. 

■ Learn which classes introduce or redefine functions. 

■ Determine which ancestor of a class introduced a data member or 
member function. 

■ Learn how data members and member functions are declared. 

■ Use event-handling functions to respond to messages. 

■ Use dispatch functions to crack Windows messages. 



Contents of this manual 



This manual has four reference chapters and one appendix: 

Chapter 1 : Library reference is an alphabetical listing of all the standard 
ObjectWindows classes, including explanations of their purpose, usage, 
and members. It also describes the nonobject elements such as structures, 
constants, variables, and macros that classes use. 

Chapter 2: Event handlers lists the ObjectWindows functions and 
notification codes that crack Windows messages. 

Chapter 3: Dispatch functions lists all of the ObjectWindows functions that 
dispatch Windows messages. 

Chapter 4: WIN API encapsulated functions lists the ObjectWindows 
functions that encapsulate Windows API functions. 

Appendix A: Inheritance diagrams lists the member functions for each class 
and shows which functions override functions defined in the base class. 
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Icons and typefaces used in this manual 





Depending on the Windows application programming (API) environment 
you are using, different ObjectWindows functions are available. If a data 
member or function is available only under the Windows 32-bit API, 
including Windows NT, the Win32 icon is displayed to the left of the data 
member or function. 

Similarly, if a class member is functional only under Winl6, the Winl6 icon 
is displayed to the left of the data member or function. Any differences in 
implementation between Winl6 and Win32 are described. Otherwise, a 
class member is considered fully functional under both the Winl6 and 
Win32 APIs. 



Boldface Boldface type indicates language keywords (such as char, switch, and 
begin) and command-line options (such as -rn). 

Italics Italic type indicates program variables and constants that appear in text. 
This typeface is also used to emphasize certain words, such as new terms. 

Monospace Monospace type represents text as it appears onscreen or in a program. It is 
also used for anything you must type literally (such as TD32 to start up the 
32-bit Turbo Debugger). 

Key1 This typeface indicates a key on your keyboard. For example, "Press Esc to 
exit a menu." 

Key1+Key2 Key combinations produced by holding down one or more keys 

simultaneously are represented as Key1+Key2. For example, you can execute 
the Program Reset command by holding down the Ctrl key and pressing F2 
(which is represented as Ctrl+F2). 

MenulCommand This command sequence represents a choice from the menu bar followed 
by a menu choice. For example, the command "File I Open" represents the 
Open command on the File menu. 

'^F' This icon indicates material you should take special notice of. 
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Conventions used in this manual 



Inline functions, those functions that are declared and defined within a 
class, are prefaced by the keyword "inline" before the function declaration. 
For example, 

inline virtual int AddString (const char far* string); 

Cross-referenced entries to ObjectWindows functions include the class 
name, the scope resolution operator, and the function name. For example, 

See also: TApplicationr.PumpWaitingMessages 

Windows API function calls are prefixed with the scope resolution operator 
(::). For example, 

See also: ::ShowWindow 



C++ data types that are keywords (such as int and long) are in lowercase 
bold. Predefined Windows types (such as HWND and UINT) are in capital 
letters; for example, 

inline BOOL TrackPopupMenu(UINT flags, int x, int y, int rsvd, HWND wnd, 

TRect* rect=0) ; 



ObjectWindows hierarchy diagram 



The ObjectWindows hierarchy diagram shows the classes that are 
described in this manual. The classes are grouped according to functional 
categories, and all related classes are in one shaded unit. A class is enclosed 
in dashed lines if it is a parent class for a multiply-inherited class. For 
example, TListBox is the parent class for TListView, which is derived from 
both TView and TListBox. The second page shows additional classes. 
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ObjectWindows class hierarchy 
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Library reference 



The ObjectWindows 

library-reference 

entries begin on page 

16. A sample entry 

that explains the 

contents of each 

entry section is 

provided on page 7. 



For more information 

on Windows types 

such as LPSTR, see 

the online Help. 



This chapter alphabetically lists the ObjectWindows classes, data members, 
member functions, macros, constants, and data types. The header file that 
defines each entry is listed opposite the entry name. Class members are 
grouped according to their access specifiers — public or protected. Within 
these categories, data members, then constructors (and the destructor, if 
one exists), and member functions are listed alphabetically. 

Because many of the properties of the classes in the hierarchy are inherited 
from base classes, only data members and member functions that are new 
or redefined for a particular class are listed. Private members are not listed. If 
any response table entries exist, they are also listed. The cross-referenced 
entries provide additional information about how to use the specified 
entry. The first sample entry (on page 7) illustrates this format. 

To find information about a particular inherited member function, use the 
inheritance diagram in A. The inheritance diagram shows the ancestry of 
the class, excluding TEventHandler and TStreamableBase, from which all 
classes are inherited. 

The following figure uses a sample class and its functions to illustrate this 
format. In this example, TBird inherits functions from TParent and 
overrides the shaded member functions, OwlHoot and OwlSleep, defined in 
the base class. The underlined functions OwlSleep and Zatslt are defined as 
virtual functions in TBird. For more information about virtual functions 
(those functions defined in base classes and overidden in derived classes), 
see the ObjectWindows Programmer's Guide. 



TParent 



TBird 




EvGetDlgCode 
OwlHoot 1 
OwlSleep 
Owl Cry 
Zatslt 
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TBird class [sample] 



bird.h 



Public data members 



This section alphabetically lists all public data members and their 
declarations, and explains how they are used. 

anOwlBeak anOwlType anOwlBeak; 

anOwlBeak is a data member that holds information about this sample class. 
This text explains what anOwlBeak contains, and how you use it. 

See also: Related data members, member functions, classes, constants, and 
types 

anOwlWing anOwlType anOWLWing; 

anOwlWing is another public data member. 



Public constructors and destructor 



Constructor 



Destructor 



This section lists any public constructors and destructor for this class. 
Classes can have more than one constructor; they never have more than 
one destructor. 

TBird (anOwlType aParameter) ; 

Constructor for a new sample class; sets the anOwlBeak data member to 

aParameter. 

-TBird; 

Destructor for a new sample class; destroys the TBird object. 



Public member functions 



EvGetDlgCode 



OwlHoot 



This section alphabetically lists all public member functions that are either 
newly defined for this class or that are redefined inherited member 
functions. If a function overrides a virtual base class function, the text 
specifies this. 

UINT OwlHoot ( ) ; 

Responds to WM_GETDLGCODE messages. 

void OwlHoot ( ) ; 
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OwlSleep 



anOwl Feather 



The OwlHoot member function causes the sample class to perform some 
action. This function overrides the function OwlHoot in its base class, 
TParent. 

See also: TParentr.OwlHoot 

virtual int OwlSleep (int index); 

The OwlSleep function performs another action and overrides the function 
OwlSleep in its base class, TParent. 

See also: TParent::OwlSleep 

Protected data members 

This section alphabetically lists all protected data members and their 
declarations, and explains how they are used. 

anOwlType anOwlFeather; 

anOwlFeather is a protected data member that holds information about this 
sample class. 

See also: Related data members, member functions, classes, constants, and 
types 



Protected constructors 



Constructor TBird(anOwlType bParameter) ; 

If the class has a protected constructor, it is listed here. 

Protected member functions 



Owldry 



Zatslt 



This section lists all protected member functions. 

BOOLEAN OwlCry; 

The OwlCry member function causes the sample class to perform some 
action. 

See also: TSomethingElse::OwlCry 

virtual int Zatslt (int index); 

The Zatslt function performs a particular function in class TBird. 
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Response table entries 



The TBird response table contains this predefined macro for the EV_xxxx 
messages and calls this member function: 



Response table entry 



Member function 



EV 



GETDLGCODE 



EVGetDlgCode 



ObjectWindows libraries 



Table 1.1 

Summary of static 

and import libraries 



The following table lists the ObjectWindows static libraries, their uses, and 
the operating system under which the library is available. These files are in 
your library directory. 

The name of the OWLWx.LIB file varies, depending on several factors — 
whether you are building a small, medium, or large memory model 
application or a WIN16 or WIN32 application. For example, if the 
application is built for a 16-bit, small memory model, the name of the 
library file is OWLWS.LIB. If you're building a flat model WIN32 
application, the name of the library file is OWLWF.LIB where "F" indicates 
a flat model application. 

Basic versions of the ObjectWindows files are included on your installation 
disk. You can build the additional versions by invoking the 
ObjectWindows makefile located in your SOURCEXOWL subdirectory 
using the -DDIAGS and -DMODEL switches. 



File name 


Application 


Use 


OWLWS.LIB 


Win16 


16-bit small model 


OWLWM.LIB 


Win16 


16-bit medium model 


OWLWL.LIB 


Win16 


16-bit large model 


OWLDWS.LIB 


Win16 


16-bit diagnostic small model 


OWLDWM.LIB 


Win16 


16-bit diagnostic medium model 


OWLDWL.LIB 


Win16 


1 6-bit diagnostic large model 


OWLWF.LIB 


Win32s, Win32 


32-bit library 


OWLDWF.UB 


Win32, Win32s 


32-bit diagnostic library 


OWLWI.LIB 


Win16 


1 6-bit import library for OWL200.DLL 


OWLDWI.LIB 


Win16 


16-bit import library for OWL200D.DLL 


OWLWFI.LIB 


Win32, Win32s 


32-bit import library for OWL200F.DLL 


OWLDWFI.LIB 


Win32, Win32s 


32-bit import library for OWL200DF.DLL 
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TBird class [sample] 



Table 1.2 

Summary of dynamic 

link libraries 



The dynamic-link (DLL) versions of ObjectWindows are contained in your 
\BIN subdirectory. The following table lists the DLL names and uses. 



File name 



OWL200.DLL 
OWL200F.DLL 
OWL200D.DLL 
OWL200DF.DLL 



Application 



Use 



Win 16 
Win 32 
Win 16 
Win32 



16-bit dynamic library 

32-bit dynamic library 

Diagnostic version of 16-bit dynamic library 

Diagnostic version of 32-bit dynamic library 



The ObjectWindows header files 



Header files, located in your OWLMNCLUDE subdirectory, contain 
declarations for class functions and definitions for data types and constants. 

Table 1 .3: Summary of header files 



File name 



Class definition 



Use 



applicat.h 

bitmapga.h 
bitset.h 

button.h 
buttonga.h 

celarray.h 
checkbox, h 
chooseco.h 

choosefo.h 

clipboar.h 

clipview.h 

color.h 



TApplication 

TBitMapGadget 

TBitSet 
TCharSet 

TButton 

TButtonGadget 

TCelArray 

TCheckBox 

TChooseColor 

TChooseFont 

TCIipboard 

TCIipboardViewer 

TColor 



Controls the basic behavior of all 
ObjectWindows applications. 

Displays an array of bitmap images. 

Sets or clears one or more bits. 
Sets or clears bytes. 

Creates different types of button controls. 

Creates button gadgets that can be clicked on 
or off. 

Creates an array of eels. 

Represents a check box control . 

Represents modal dialog boxes that allow color 
selection. 

Represents modal dialog boxes that allow font 
selection. 

Contains functions that control how Clipboard 
data is handled. 

Registers a TCIipboardViewer as a Clipboard 
viewer. 

Contains functions used to simplify standard 
Windows color operations. 
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Table 1 .3: Summary of header files (continued) 



combobox.h 

commdial.h 

compat.h 

control.h 

controlb.h 

controlg.h 

dc.h 



decframe.h 

decmdifr.h 

dialog.h 

dispatch. h 
docmanag.h 

docview.h 

edit.h 

editfile.h 

editsear.h 



TCombobox 



TCommonDialog 



TControl 

TControlBar 

TControlGadget 

TBandlnfo, TCIientDC, 
TCreatedDC, TDC, 
TDesktopDC, TDibDC 
TIC, TMemoryDC, 
TMetaFileDC, TPaintDC 
TPrintDC, TScreenDC, 
TWindowDC 

TDecoratedFrame 

TDecoratedMDIFrame 

TDialog 
TDialogAttr 



TDocManager 

TDocTemplate 

TDocument, TView, 
TWindowView, TStream, 
TlnStream, TOutStream 

TEdit 

TEditFile 

TEditSearch 



Creates combo boxes or combo box controls in 
a window, and class TComboBoxData, which is 
used to transfer data between combo boxes. 

Abstract base class for TCommonDialog 
objects. 

Defines functions and constants used internally 
by ObjectWindows. 

Used to create control objects in derived 
classes. 

Implements a control bar that provides 
mnemonic access for its button gadgets. 

Allows controls to be placed in a gadget 
window. 

GDI DC wrapper classes that create 
DC objects. 



Creates a client window into which decorations 
can be placed. 

Creates a frame object that supports decorated 
child windows. 

Creates modal and modeless dialog box 

interface elements. 

Holds the dialog box element's attributes. 

Defines dispatch functions designed to crack 
Windows messages. 

Creates a document manager object that 
manages the documents and templates. 
Creates the templates. 

Create, destroy, and send messages about 
document views. 

Creates an edit control interface element. 

Creates a file editing window. 

Creates an edit control that responds to search 
and replace commands. 
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TBird class [sample] 



Table 1 .3: Summary of header files (continued) 



editview.h 
eventhan.h 

except.h 



filedoc.h 
findrepl.h 

floatfra.h 
framewin.h 

gadget.h 

gadgetwi.h 
gauge.h 
gdibase.h 
gdiobjec.h 



groupbox.h 

inputdia.h 
keymodet.h 

layoutco.h 
layoutwi.h 

listbox.h 

listview.h 



TEditView 
TEventHandler 

TXOwl 

TXCompatibility 
TXOutOfMemory 
TStatus 

TFileDocument 

TFindDialog, 
TFindReplaceDialog:: 

TFIoatingFrame 

TFrameWindow 

TMenuDescr 
TGadget 

TGadgetWindow 

TGauge 

TGdiBase 

TGdiObject 
TPen, TBrush, TFont, 
TPalette, TBitmap, 
Tlcon, TCursor, TDib, 
TRegion. 

TGroupBox 

TlnputDialog 
TKeyboardModeTracker 

TLayoutConstraint 
TLayoutMetrics 

TListBox 
TListBoxData 

TListView 



View wrapper for TEdit. 

Used to derive class capable of handling 
messages. 

Base exception-handling class. 
Describes a status exception. 
Describes an out-of-memory exception. 
Included for backward compatibility. 

Opens and closes document views. 

These classes create and define the attributes 
of modeless dialog boxes that respond to 
search and replace commands. 

Implements a floating frame within a parent 
window. 

Controls window-specific behavior such as 
keyboard navigation and command processing. 
Describes a menu bar. 

Creates gadget objects that belong to a gadget 
window and have specified attributes. 

Maintains a list of tiled gadgets for a window. 

Establishes the behavior of gauge controls. 

Abstract base class for all GDI classes. 

Base GDI class. 

These classes create specified GDI objects. 



Creates a group box object that represents a 
group box element in Windows. 

Generic dialog box. 

A mix-in class designed to track changes in 
keyboard modes. 

Creates layout constraints. 

Contains the layout constraints used to define 
the layout metrics for a window. 

Creates a list box object. 

Used to transfer the contents of a list box. 

Provides views for list boxes. 
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Table 1 .3: Summary of header files (continued) 



mdi.h 

mdichild.h 
menu.h 

messageb.h 

metafile.h 

module.h 

opensave.h 

owlall.h 

owlcore.h 
owldefs.h 

owlpch.h 

point.h 

preview.h 

printdia.h 
printer.h 

radiobut.h 
scrollba.h 



scroller, h 
signatur.h 



TMDICIient 
TMDIFrame 

TMDIChild 

TMenu, TPopupMenu, 
TSystemMenu 

TMessageBar 

TMetaFilePict 

TModule 

TOpenSave 



TPoint, TSize, TRect 
TDroplnfo 
TProclnstance 
TPointer 

TPreviewPage 



TPrintDialog 

TPrinter 

TPrintout 

TPrinterAbortDIg 

TRadioButton 

TScrollBar 

TScrollBarData 
TScroller 



Manages MDI child windows. 
The main window of MDI-compliant 
applications. 

Defines the behavior of MDI child windows. 

Create menu objects. 

Implements a message bar. 

A wrapper class used with TMetaFileDC. 

Defines the basic behavior for ObjectWindows 
libraries and applications. 

Base class for modal open and save dialog 
boxes. 

Include file for all of the ObjectWindows 
classes. 

Include file for the core ObjectWindows classes. 

Includes definitions of macros used by all 
ObjectWindows programs. 

Contains definitions of macros, data, and 
functions used by ObjectWindows. 

Mathematical classes. 

Supports file-name drag and drop operations. 

A Win 16 support class. 

Provides exception-safe pointer manipulation. 

Displays a document page in a print preview 
window. 

Displays a modal print or print setup dialog box. 

Represents the printer device. 
Represents the printed document. 
Represents the printer-abort dialog box. 

Create a radio button control. 

Represents a vertical or horizontal scroll bar 

control. 

Contains the values of the thumb position on 

the scroll bar. 

Implements automatic window scrolling. 

Defines the message cracking signature 
templates used by ObjectWindows event- 
handling functions. 



14 



ObjectWindows 2.0 Reference Guide 



TBird class [sample] 



Table 1 .3: Summary of header files (continued) 



slider.h 

static.h 

statusba.h 

textgadg.h 

tinycapt.h 

toolbox.h 

validate, h 



vbxctl.h 

version.h 

window.h 

windowev.h 



TSIider 


Defines the basic behavior of sliders. 


THSIider 


A horizontal slider. 


TVSIider 


A vertical slider. 


TStatic 


Create a static control in a window. 


TStatusBar 


Constructs a status bar. 


TTextGadget 


Construct a text gadget object. 


TTinyCaption 


Produces a smaller caption bar for a windc 


TToolBox 


Creates a toolbox object with a specified 




number of rows and columns. 


TValidator 


Base validator class. 


TPXPictureValidator 


Picture validator. 


TFilterValidator 


Filter validator. 


TRangeValidator 


Range validatator. 


TLookupValidator 


Lookup validation. 


TStringLookupValidator 


String validation. 


TVbxControl 


Interface for VBX controls. 


TVbxEventHandler 


Handles events from VBX controls. 




Defines the internal version number of the 




ObjectWindows library. 



TWindow 



Provides window-specific behavior and 
encapsulates many of the Windows API 
functions. 

Defines event handlers and response table 
macros for Windows messages. 



The ObjectWindows resource files 



The ObjectWindows resource files define resource and command IDs. 



Table 1.4 

Summary of resource 

files 



File name 



Use 



Directory of OWLMNCLUDE 

docview.rh Defines resource and command IDs to use with docview.h and 

docview.rc. 
edit.rh Defines command IDs to use with edit.h. 

editfile.rh Defines resource and command IDs to with in editfile.rc and 

editfile.h. 
editsear.rh Defines resource and command IDs to use in editsear.rc and 

editsear.h. 
except. rh Defines string resource IDs to use with except. h and except. re. 
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Table 1 .4: Summary of resource files (continued) 



inputdia.rh Defines resource IDs to use with inputdia.rc and inputdia.h. 

mdi.rh Defines resource & command IDs to use with mdi.h. 

printer.rh Defines resource IDs to use with printer.rc and printer.h. 

slider.rh Defines resource IDs to use with slider.h. 

validate.rh Defines resources to use with TValidator and derived classes, 

window.rh Defines command IDs to use with window.h. 



The ObjectWindows library reference 



The following section lists the classes, data types, and symbolic constants 
used by ObjectWindows applications. 



BF xxxx constants 



checkbox.h 



Table 1.5 
Button flag constants 



Check box and radio button objects use the button flag constants to indicate 
the state of a selection box. 



Constant 



BF_CHECKED 
BF_GRAYED 
BF UNCHECKED 



Meaning 



Item is checked. 
Item is grayed. 
Item is unchecked. 



See also: TCheckbox::GetCheck, TCheckboxr.SetCheck 



CM xxxx edit constants 



edit.rh 



Table 1.6 

Command-based 

constants 



TEdit defines these command-based member functions, which are invoked 
in response to a particular edit menu selection or command. 



Constant 



CM_EDITCLEAR 

CM_EDITCOPY 

CM_EDITCUT 

CM_EDITDELETE 

CM_EDITPASTE 

CM EDITUNDO 



Member function 



Menu equivalent 



TEditCMEditClear 

TEdit::CMEditCopy 

TEditCMEditCut 

TEdit::CMEditDelete 

TEditCMEditPaste 

TEdit::CMEditUndo 



EditlClear 

EditlClear 

EditlCut 

Editl Delete 

EditlPaste 

EditlUndo 
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CM xxxx edit file constants 



CM xxxx edit file constants 



docview.rh 



Table 1.7 

Command-based 

constants 



These command-based member functions are invoked in response to open, 
close, print, and save commands. 



Constant 


Member function 


Menu equivalent 


CM FILECLOSE 






CM FILENEW 


TEditFiler.CmFileNew 


FilelNew 


CM FILEOPEN 


TEditFile::CmFileOpen 


FilelOpen 


CM FILEPRINT 




Filel Print 


CM FILEPRINTERSETUP 




Filel Printer Setup 


CM FILESAVE 


TEditFiler.CmFileSave 


FilelSave 


CM FILESAVEAS 


TEditFile::CmFileSaveAs 


FilelSave As 



CM xxxx edit file exit constant 



window.rh 



Table 1.8 

Command-based 

constant 



This command-based member function is invoked in response to a file exit 
request from a user. 



Constant 



Member function Menu equivalent 



CM EXIT 



TWindowr.CmExit 



FilelExit 



CMjcxxx edit replace constants 



editsear.rh 



Table 1.9 

Command-based 

constants 



These command-based member functions are invoked when the 
corresponding find and replace command is received. 



Constant 



CM_EDITFIND 
CM_EDITFINDNEXT 
CM EDITREPLACE 



Member function 



Menu equivalent 



TEditWindow::CMEditFind EditlFind 

TEditWindow::CMEditFindNext Editl Findl Next 

TEditWindowr.CMEditReplace Editl Replace 
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CM xxxx MDI constants 



CM xxxx MDI constants 



mdi.rh 



Table 1.10 

Command message 

constants 



These MDI functions are invoked when the corresponding MDI command 
message is received. 



Constant 



CM_ARRANGEICONS 

CM_CASCADECHILDREN 
CM_CLOSECHILDREN 
CM_CREATECHILD 
CM TILECHILDREN 



Member function 



TMDICIient::CmArrangelcons 

TMDICIient::CmCascadeChildren 
TMDICIientr.CmCloseChildren 
TMDICIient::CmCreateChild 
TMDICIient::CmTileChildren 



Menu equivalent 



WindowlArrange 
Icons 

WindowlCascade 
WindowlClose All 

WindowlTile 



DECLARE RESPONSE TABLE macro 



eventhan.h 



To handle events for a class, you need to declare a response table using the 
DECLARE_RESPONSE_TABLE macro within the class definition and you 
need to define the response table using one of the 

DEFINE_RESPONSE_TABLE macros. For example, to declare a response 
table, use 

DECLARE_RESPONSE_TABLE (Class) ; 

where Class represents the name of the current class. 

See also: DEFINE_RESPONSE_TABLE macros, END_RESPONSE_TABLE 
macro 

For more information about response table entries, see TEventHandler 
(where the response table entries are defined) or TWindow (where the 
member functions are defined). For more information about how to declare, 
define, and add message response entries to a response table, see Chapter 5 
in the ObjectWindows Programmer's Guide. 



DEFINE DOC TEMPLATE CLASS macro 



docmanag.h 



Used to create a document template, the 

DEFINE_DOC_TEMPLATE_CLASS takes three arguments: the name of the 
document class that holds the data, the name of the view class that displays 
the data, and the name of the template class. The following examples from 
DVSAMPLE.CPP, a sample program on your distribution disk, associate 
document and view classes with new template classes. 
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DEFINE DOC TEMPLATE CLASS macro 



DEFINE_DOC_TEMPLATE_CLASS(TFileDocument, TListView, ListTemplate) ; 
DEFINE_DOC_TEMPLATE_CLASS(TFileDocument, TEditView, EditTemplate) ; 

See also: TDocTemplate 

DEFINE_RESPONSE_TABLE macros eventhan.h 

The DEFINE_RESPONSE_TABLEx macro takes one plus x number of 
arguments: the name of the class that is defining the response table, and its 
immediate as well as any virtual base classes. Use the 
END_RESPONSE_TABLE macro to end the definition for the response 
table. Between the DEFINE_RESPONSE_TABLE and 
END_RESPONSE_TABLE macros, you might need to insert the message 
response entries. For example, 

DEFINE_RESP0NSE_TABLE1 (TMyClass, TWindow) 

EV_WM_PAINT, 

EV_WM_LBUTTONDOWN , 
END_RESPONSE_TABLE; 

In this example, EV_WM_PAINT and EV_WM_LBUTTONDOWN 
illustrate the message response entries for the class TMyClass derived from 

TWindow. 

The following table shows the form the DEFINE_RESPONSE_T ABLE 
macro takes depending on the number of base classes. 

Base classes Macro 

DEFINE_RESPONSE_TABLE(Class) 

1 DEFINE_RESPONSE_TABLE(Class, Base) 

2 DEFINE_RESP0NSE_TABLE2(Class, Basel, Base2) 

3 DEFINE_RESP0NSE_TABLE3(Class, Basel , Base2, Base3) 

See also: END_RESPONSE_T ABLE macro 

dmxxxx document manager mode constants docmanag.h 

TDocManager uses the dmxxxx constants to indicate if a document supports 
single or multiple open documents, and to indicate if it has file menu IDs. 



Table 1.11 



Document manager Constant Meaning 

mode constants 



dmMenu Sets IDs for file menu. 

dmMDI Supports multiple open documents. 
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dmxxxx document manager mode constants 



Table 1 .1 1 : Document manager mode constants (continued) 



dmNoRevert Disables the Filel Revert menu command. 

dmSaveEnable Enables FilelSave menu command. 

dmSDI Does not support multiple open documents. 



See also: TDocManager::TDocManager 



dnxxxx document message enum 



docmanag.h 



TDocManager uses the dnxxxx message constants to indicate that a 
document or view has been created or closed. You can set up response table 
entries for these messages using the EV_OWLVIEW or 
EV_OWLDOCUMENT macros. See Chapter 9 in the ObjectWindows 
Programmer's Guide for information about how to do this. 



Table 1.12 

Document message 

enum 



Constant 



Meaning 



dnCreate A new document or view has been created. 

dnClose A document or view has been closed. 



See also: TDocManager ::TDocManager 



dt document view constants 



docmanag.h 



dtxxxx constants are used by TDocument and TDocTemplate to create 
templates. Several constants are equivalent to the OFN_xxxx constants 
defined by Windows in commdlg.h. 



Table 1 .13: Document view constants 



Constant 



Windows equivalent 



Meaning 



dtAutoDelete 

dtAutoOpen 

dtCreatePrompt 

dtFileMustExist 

dtHidden 

dtHideReadOnly 

dtNewDoc 



(OFN_CREATEPROMPT) 
(OFN_FILEMUSTEXIST) 

(OFN_HIDEREADONLY) 



Deletes the document when the last view is deleted. 

Opens a document upon creation. 

Prompts the user before creating a document that does not 
currently exist. 

Lets the user enter only existing file names in the File Name 
entry field. If an invalid file name is entered, causes a warning 
message to be displayed. 

Hides the template from the user's selection. 

Hides the read-only check box. 

Creates a new document with no path specified. 
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dt document view constants 



Table 1.13: Document view constants (continued) 



dtNoAutoView 
dtNoReadOnly 
dtNoTestCreate 



(OFN_NOREADONLYRETURN) 
(OFN_NOTESTFILECREATE) 



dtOverwritePrompt 


(OFN.OVERWRITEPROMPT) 


dtPathMustExist 


(OFN_PATHMUSTEXIST) 


dtProhibited 


(OFN_ALLOWMULTISELECT) 
(OFN ENABLEHOOK) 
(OFNLENABLETEMPLATE) 
(OFN_ENABLETEMPLATEHANDLE) 


dtReadOnly 


(OFN_READONLY) 


dtSelected 




dtSingleView 




dtUpdateDir 





Does not automatically create the default view type. 

Returns the specified file as writeable. 

Does not perform document-creation tests. The file is created 
after the dialog box is closed. If the application sets this flag, 
there is no check against write protection, a full disk, an open 
drive door, or network protection. For certain network 
environments, this flag should be set. 

When the Save As dialog box is displayed, asks the user if it's 
OK to overwrite the file. 

Allows only valid document paths to be entered. If an invalid 
path name is entered, causes a warning message to be 
displayed. 

Doesn't support these specified Windows options. 



Checks the read-only check box when the dialog box is 
created. 

Indicates the last selected template. 

Provides only a single view for each document. 

Updates the directory with the dialog directory. 



See also: TDocumentr.CreateFlags, TDocTemplater.Flags 



END RESPONSE TABLE macro 



eventhan.h 



This macro indicates the end of a response table. 

END_RESPONSE_TABLE; 

See also: DEFINE RESPONSE TABLE macro 



EV xxxx macros 



windowev.h 



The EV_xxxx macros create response table entries that match events to 
member functions. See Chapter 2 for a list of the EV_xxxx macros and their 
corresponding functions and Chapter 5 in ObjectWindows Programmer's 
Guide for details about how to use these macros. 
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lv xxxx macros 



Table 1 .14: EV xxxx macros 



Macro 



Meaning 



EV_CHILD_NOTIFY(id,notifyCode,method) 

EV_CHILD_NOTIFY_ALL_CODES 

EV_CHILD_NOTIFY_AND_CODE(id, notifyCode, method) 

EV_COMMAND(id, method) 

EV_COMMAND_AND_ID(id, method) 

EV_COMMAND_ENABLE(id, method) 

EV_MESSAGE(message, method) 
EV_NOTIFY_AT_CHILD(notifyCode, method) 
EV_OWLDOCUMENT(id, method) 
EV_OWLNOTIFY(id, method) 
EV_OWLVIEW(id, method) 
EV_REGISTERED(str, method) 



Handles child ID notifications (for example, button, edit 
control, list box, combo box, and scroll bar notification 
messages) at the child's parent window. Passes no 
arguments. 

Passes all notifications to the response function and 
passes the notification code in as an argument. 

Handles child ID notifications at the child's parent window 
and passes the notification code as an argument. 

Handler for menu selections, accelerator keys, and push 
buttons. 

Handler for multiple commands using a single response 
function. Passes the menu ID in as an argument. 

Enables and disables commands such as buttons and 
menu items. 

General purpose macro for Windows WM_xxxx messages. 

Handles all child ID notifications at the child window. 

Handles new document notifications. 

Generic document handler. 

Handles view notifications. 

Handles registered MSG messages. 



ID xxxx file constants 



inputdia.rh 



These are the resource and control IDs for the input dialog box. 



Table 1.15 
ID file constants 



Constant 



Meaning 



IDDJNPUTDIALOG 

IDJNPUT 
ID PROMPT 



Resource ID number for the input dialog 

box. 

Control ID for the user input. 

Control ID for the static text. 



See also: TInputDialog::SetUp Window 
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ID_xxxx printer constants 



IDjcxxx printer constants 



printer.rh 



Table 1.16 
ID printer constants 



The ID_xxxx printer constants are the resource and control IDs for the 
printer abort dialog box. 



Constant 



Meaning 



IDD_ABORTDIALOG 
IDJTTLE 
ID_DEVICE 
ID PORT 



Resource ID number for the abort dialog box. 
Control ID for the selected printer driver. 
Control ID for the selected printer. 
Control ID for the selected printer port. 



IDA xxxx accelerator ID constants 



editfile.rh 



IDA_EDITFILE is a resource ID for accelerator keys. 



Table 1.17 

Accelerator ID 

constants 



Constant 



Meaning 



IDAJEDITFILE Resource ID for accelerator keys. 



IDM xxxx menu ID constant 



editfile.rh 



IDM EDITFILE is a resource ID for menu selections. 



Table 1.18 
Menu ID constants 



Constant 



Meaning 



IDM EDITFILE 



Resource ID for menu selections. 



IDS_xxxx document string ID constants 



docview.rh 



Table 1.19 

Document string ID 

constants 



Constant 



IDS_DOCCHANGED 

IDSJDOCUST 

IDS_NOTCHANGED 

IDS_UNABLECLOSE 

IDSJJNABLEOPEN 

IDS_UNTITLED 

IDS VIEWUST 



Displays these messages: 



If the document has been changed, displays the message, "Do you 

want to save the changes?" 

Document is a document type. 

The document has not been changed. 

Document manager is unable to close the document. 

Document manager is unable to open the document. 

Document is untitled. 

Document is a view type. 
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I us xxxx edit file ID constants 



IDS xxxx edit file ID constants 



editfile.rh 



Table 1.20 
Edit file ID constants 



ObjectWindows defines these string constants used by edit and file classes 
to display information about files. 



Constant 



IDS_FILECHANGED 
IDS_FILEFILTER 
IDSJJNABLEREAD 
IDS UNABLEWRITE 



Meaning 



The text in the file has changed. Do you want to save the changes? 
Use this filter to display text files. 
Unable to read the file from the disk. 
Unable to write the file to the disk. 



IDS_xxxx exception messages 



except.rh 



The following list includes general and application exception message 
constants grouped according to message types. 



Table 1.21 

Exception message 

constants 



Constant 



Meaning 



IDSJNVAUDMAINWINDOW 

IDSJNVAUDMODULE 

IDS_NOAPP 

IDS_OUTOFMEMORY 

IDSJJNKNOWNERROR 

IDS_MENUFAILURE 

IDS_VALIDATORSYNTAX 

IDS_PRINTERERROR 

Owl 1 compatibility messages: 

IDSJNVALIDCHILDWINDOW 

IDSJNVALIDCLIENTWINDOW 

IDSJNVALIDWINDOW 

TXWindow messages: 

IDS_CHILDCREATEFAIL 

IDS_CHILDREGISTERFAIL 

IDS_CLASSREGISTERFAIL 

IDS_WINDOWCREATEFAIL 

IDS_WINDOWEXECUTEFAIL 

GDI messages: 

IDS_GDIALLOCFAIL 

IDS_GDICREATEFAIL 

IDS_GDIDELETEFAIL 

IDS_GDIDESTROYFAIL 

IDS_GDIFAILURE 

IDS GDIFILEREADFAIL 



Invalid MainWindow 

Invalid module specified for window 

No application object 

Out of memory 

Unknown error 

Menu creation failure 

Validator syntax error 

Printer error 

Invalid child window 
Invalid client window 
Invalid window 

Child create fail for window 

Child class registration fails for window 

Class registration fails for window 

Create fail for window 

Execute fail for window 

GDI allocate failure 
GDI creation failure 
GDI object delete failure 
GDI object destroy failure 
GDI failure 
GDI file read failure 
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IDS_xxxx exception messages 



Table 1.21: Exception message constants (continued) 



IDSJNVAUDDIBHANDLE 
IDS GDIRESLOADFAIL 



Invalid DIB handle 
GDI resource load failure 



IDS xxxx listview ID constants 



listview.rc 



Table 1.22 

Listview string ID 

constants 



ObjectWindows uses list view constants to define operations perfomed on 
views. These include clearing the document, inserting a new line, copying 
text to the Clipboard, and so on. 



Constant 



Meaning 



IDS LISTVIEW 



Resource ID for listview constants. 



IDSjcxxx printer string ID constants 



printer.rh 



ObjectWindows defines several constants used by printer classes to 
determine the printer status. 



Table 1.23 

Printer string ID 

constants 



Constant 



IDS_PRNCANCEL 

IDS_PRNERRORCAPTION 

IDS_PRNERRORTEMPLATE 

IDS_PRNGENERROR 

IDS_PRNMGRABORT 

IDS_PRNON 

IDS_PRNOUTOFDISK 

IDS PRNOUTOFMEMORY 



String displayed 



Printing is canceled. 
Printer error occurred. 
Document was not printed. 
Error encountered during printing. 
Printing aborted in Print Manager. 
Printer is on. 
Out of disk space. 
Out of memory. 



IDS xxxx validator ID constants 



validator.rh 



Table 1.24 

Validator ID 

constants 



ObjectWindows defines several constants used by validator classes to 
determine the validator status. 



Constant 



IDS_VALPXPCONFORM 
IDS_VALINVALIDCHAR 
IDSJ/ALNOTINRANGE 
IDS VALNOTINLIST 



Meaning 



Item doesn't conform to correct picture format. 
Character isn't one of the valid entries. 
Entry isn't within the specified range. 
String isn't found in the list of valid entries. 
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IDW MDICLIENT constant 



IDWJ/IDICLIENT constant framewin.h 

Child ID constant used to identify MDI client windows. 

IDW_MDICLIENT 

IDWJ/IDIFIRSTCHILD constant framewin.h 

Child ID constant used to identify the first MDI client window. 

IDW_FIRSTMDICHILD 

ImParent constant layoutco.h 

LmParent is used to construct layout metrics (for example, edge and size 
constraints). 

#define ImParent 

See also: TLayoutConstraint 

LongMulDiv function scroller.h 

TScroller uses this function to convert horizontal range values (XRange) 
from the scroll bar to horizontal scroll values (XScrollValue) and vice versa, 
or to convert vertical range values (YRange) from the scroll bar to vertical 
scroll values (YScrollValue) and vice versa. 

inline long LongMulDiv (long mull, long mul2, long divl); 

See also: TScroller 

MAX_RSRC_ERROR_STRING constant except.h 

Maximum number of characters possible for an error message. 

const int MAX_RSRC_ERROR_STRING = 255; 
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NBits function 



NBits function color.h 

WORD NBits (int colors); 

Returns the bit count corresponding to the given color count. 

See also: NColors, TColor class 

NColors function color.h 

Returns the color count corresponding to the given bit count, or -1 if the bit 
count is not supported by Windows. Bit counts currently supported are 1, 
4, 8, and 24. 

int NColors (WORD bitCount); 

See also: NBits, TColor class 

ofxxxx document open enum docview.h 

This enum defines the document and open sharing modes used for 
constructing streams and storing data. Any constants that have the same 
functionality as those used by OLE 2.0 docfiles are indicated in the 
following table; for example, STGMJTRANSACTED, STGM_CONVERT, 
STGM_PRIORITY, and STGMJDELETEONRELEASE. 

Although files are typically used for data storage, databases or 
spreadsheets can also be used. I/O streams rather than DOS use these bit 
values. Documents open the object used for storage in one of the following 
modes: 

Constant Meaning 

ofParent A storage object is opened using the parent's mode. 

ofRead A storage object is opened for reading. 

ofWrite A storage object is opened for writing. 

ofReadWrite A storage object is opened for reading and writing. 

ofAtEnd Seek to end-of-file when opened originally. 

of Append Data is appended to the end of the storage object. 

ofTruncate An already existing file is truncated. 

ofNoCreate Open fails if file doesn't exist. 

of NoReplace Open fails if file already exists. 

ofBinary Data is stored in a binary, not text, format. Carriage returns are not 

stripped. 

oflosMask All of the above bits are used by the ios class. 
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ofxxxx document open enum 



Constant 



Meaning 



ofTransacted Changes to the storage object are preserved until the data is either 

committed to permanent storage or discarded. (STGM_TRANSACTED) 
of Preserve Backs up previous storage data using before creating a new storage 

object with the same name. (STGM_CONVERT) 
ofPriority Supports temporary, efficient reading before opening the storage. 

(STGM_PRIORITY) 
ofTemporary The storage or stream is automatically destroyed when it is destructed. 

(STGIvLDELETEONRELEASE) 



See also: TStream, InStream, OutStream 



pfxxxx property attribute constants 



docview.h 



These constants define document and view property attributes. Documents, 
views, and applications use these attributes to determine how to process a 
document or view. 



Constant 



Meaning 



pfGetText Property is accessible in a text format. 

pfGetBinary Property is accessible as a native nontext format. 

pfConstant Property can't be changed for the object instance. 

pfSettable Property can be set as a native format. 

pfUnknown Property is defined but unavailable for the object. 

pfHidden Property should be hidden from the user during normal browsing. 

pfUserDef Property has been user-defined at run time. 



See also: TDocument, TView 



BUILDOWLDLL macro 



owldefs.h 



_BUILDOWLDLL, which must be defined to build the ObjectWindows 
DLL, is used internally to control values for the _OWLCLASS, 
_OWLDATA, and _OWLFUNC macros. It is included in ObjectWindows 
makefiles to build the ObjectWindows DLL. 

_BUILDOWLDLL 

See also: OWLDLL 



28 



ObjectWindows 2.0 Reference Guide 



OWLCLASS macro 



OWLCLASS macro owldefs.h 

Used internally by ObjectWindows, _OWLCLASS is the ObjectWindows 
version of _RTLCLASS adjusted to export and import WIN32 DLLs. 

Possible definitions for this macro are _export, far, near, tiny, large, 

or huge model. 

_0WLCLASS 

OWLDATA macro owldefs.h 

The macro _OWLDATA is the ObjectWindows version of _RTLDATA 
adjusted to export and import WIN32 DLLs for ObjectWindows. Possible 
definitions for this macro are export, import, or nothing. 

_0WLDATA 

OWLDLL macro owldefs.h 

_OWLDLL, which is automatically defined if _RTLDLL is turned on, 
controls values for the _OWLCLASS, _OWLDATA, and _OWLFUNC 
macros. It must be defined if you are writing ObjectWindows applications 
or DLLs that use DLLs. This macro can also be turned on by a makefile. 

_0WLDLL 

OWLFAR macro owldefs.h 

The macro _OWLFAR is the ObjectWindows version of _RTLFAR adapted 
to promote far data pointers in DLLs for ObjectWindows. Possible 
definitions for this macro are __export or import. 

_0WLFAR 

OWLFUNC macro owldefs.h 

The macro _OWLFUNC is ObjectWindows function version of _RTLFUNC 
adapted to export and import functions if building WIN32 DLLs for 
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OWLFUNC macro 



ObjectWindows. Possible definitions for this macro are export, import, 

far, or near. 



OWLFUNC 



OWLGetVersion function owldefs.h 

Returns the version number of the ObjectWindows library. The version 
number is represented as an unsigned short. 

unsigned short far _0WLFUNC OWLGetVersion () ; 

shxxxx document sharing enum docview.h 

The following file-sharing modes are available when opening document 
streams. 

Table 1.25 Constant Meaning 

shxxxx constants : : — 

shCompat Used for noncompliant applications, but should be avoided if possible. 

shNone DENY_ALL functionality. 

shRead DENY_WRITE functionality. 

shWrite DENY_READ functionality. 

shReadWrite DENY_NONE functionality. 

shDefault Use stream implementation default value. 

shMask shCompatlshNonelshReadlshWrite 

TActionFunc typedef window.h 

typedef void (*TActionFunc) (TWindow* win, void* param); 
Passes a function pointer to TWindow ::ForEach. 
See also: TWindow: :ForEach 

TActionMemFunc typedef window.h 

typedef void(TWindow: :* TActionMemFunc) (TWindow* win, void* param); 
Passes a member function pointer to TWindow: :ForEach. 
See also: TWindow: :ForEach 
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TAnyPMF typedef 



TAnyPMF typedef dispatch.h 

typedef void (GENERIC: : *TAnyPMF) ( ) ; 

TAnyPMF is a generic pointer to a member function. 

TAnyDispatcher typedef dispatch.h 

typedef LRESULT(*TAnyDispatcher) (GENERICS, TAnyPMF, WPARAM, LPARAM); 

TAnyDispatch is a message dispatcher type. All message dispatcher 
functions conform to this type and take four parameters: 

■ A reference to an object 

■ A pointer to the member function in which the signature varies 
according to the cracking that the function performs 

■ WPARAM 

■ LPARAM 

TApplication class applicat.h 

Derived from TModule, TApplication acts as an object-oriented stand-in for a 
Windows application module. TApplication and TModule supply the basic 
behavior required of a Windows application. TApplication member 
functions create instances of a class, create main windows, and process 
messages. See Chapter 3 in the ObjectWindows Programmer's Guide for 
information about using application objects. 

Public data members 

cmdLine const char far* cmdLine; 

A null-terminated string, cmdLine points to a copy of the command-line 
arguments passed when the TApplication object is constructed. cmdLine is 
different from the WIN32 cmdLine in which the full path name of the 
module is appended to the command-line arguments. Whether running 
under WIN16 or WIN32, ObjectWindows' T Application: xmdLine data 
member includes only the command-line arguments. Note that the run- 
time library global variables _argv[] and _argc contain identical 
information for both WIN16 and WIN32 APIs, and that _argv[0] points to 
the full path name of the module. 
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TApplication class 



cmdShow 



HAccTable 



hPrevlnstance 



nCmdShow 



See also: TApplication: :T Application 

int cmdShow; 

nCmdShow indicates how the main window is to be displayed (either 
maximized or as an icon). These correspond to the WinMain parameter 
CmdShow. See 7 Application: mCmdShow for a description of these constants. 

See also: TApplicationr.nCmdShow 

HACCEL HAccTable; 

Included to provide backward compatibility, HAccTable holds a handle to 
the current Windows accelerator table being used by the application. New 
applications should instead use the accelerator table handle TWindow. 

See also: TWindowr.LoadAcceleratorTable, TWindozuAttr 

HINSTANCE hPrevlnstance; 

Contains the handle of the previously executing instance of the Windows 
application. If hPrevlnstance is 0, there was no previously executing instance 
when this instance began execution. Under Win32, this value is always 0. 

int nCmdShow; 

Indicates how the main window is to be displayed (either maximized or as 
an icon). These correspond to the WinMain parameter CmdShow. nCmdShow 
can contain one of the following Windows API constants: 



Constant 



Meaning 



SW_SHOWDEFAULT 

SW_HIDE 

SW_MINIMIZE 

SW_SH0W 

SW_SHOWMAXIMIZED 

SW_SHOWMINIMIZED 

SW_SH0WNA 

SW_SHOWNOACTIVATE 

SW_SH0WN0RMAL 

SW SH0WSM00TH 



Shows the default SW_xxxx command. 

Hides the window. 

Minimizes the specified window. 

Activates a window using current size and position. 

Displays a maximized window. 

Displays a minimized window. 

Displays window in its current state. 

Displays the window as an icon. 

Displays a window in its original size and position. 

Shows a window by updating it in a bitmap and then copying the 

bits to the screen. 



See also: ::ShowWindow 



Public constructors and destructor 



Constructor 



TApplication (const char far* name = 
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TApplication class 



Constructor 



Destructor 



This TApplication constructor creates a TApplication object. Use this 
constructor in your OwlMain function. 

TApplication (const char far* name = 0, HINSTANCE instance, 

HINSTANCE prevlnstance, const char far* cmdLine, int cmdShow, 
TModule* gModule = : : Module) ; 

This TApplication constructor creates a TApplication object with the 
application name (name), the application instance handle (instance), the 
previous application instance handle (prevlnstance), the command line 
invoked (cmdLine), and the number of main windows that should be shown 
(cmdShow). If you want to create your own WinMain, use this constructor 
because it provides access to the various arguments required by WinMain. 

See also: T Application: mCmdShow 

-TApplication () ; 

~T Application destroys the TApplication object. 



Public member functions 



BeginModal int BeginModaKTWindow* window, int flags = MB_APPLMODAL) ; 

BeginModal is called to begin a modal window's modal message loop. After 
determining which window to disable, BeginModal saves the current status 
of the window, disables the window, calls MessageLoop, and then reenables 
the window when the message loop is finished. The flags (which are the 
same as those passed to the Windows API function MessageBox) determine 
how BeginModal treats the window, flags can be one of the following values: 



Constant 



Meaning 



MB APPLMODAL 



MB_SYSTEMMODAL 
MB TASKMODAL 



The window to be disabled (which is usually an ancestor of the modal 

window) is identified by window. If window is 0, no window is 

disabled. 

The window to become system modal is identified by window. 

All top-level windows are disabled, and window\s ignored. 



BeginModal returns -1 if an error occurs. 
See also: r.MessageBox 

BWCCEnabled inline BOOL BWCCEnabledO const; 

Indicates if the BWCC (Borland Custom Controls library) is enabled. 
Returns TRUE if BWCC is enabled or FALSE if BWCC is disabled. 

CanCIOSe virtual BOOL CanCloseO; 
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TApplication class 



Condemn 



Ctl3dEnabled 



EnableBWCC 



Returns TRUE if it's OK for the application to close. By default, CanClose 
calls the CanClose member function of its main window and returns TRUE 
if both the main window and the document manager (TDocManager) can be 
closed. If any of the CanClose functions return FALSE, the application 
doesn't close. This member function is seldom redefined; closing behavior 
is usually redefined in the main window's CanClose member function, if 
needed. 

See also: TWindow: -.CanClose, T Window: :EvDestroy 

void Condemn (TWindow* win); 
Performs window cleanup. 

inline BOOL Ctl3dEnabled() ; 

Returns TRUE if three-dimensional support (Microsoft 3-D Controls 
Library DLL) is enabled. 

See also: TApplication: :EnableCtl3d 

void EnableBWCC (BOOL enable = TRUE, UINT Language = 0); 

Loads and registers BWCC.DLL if you are running 16-bit applications or 
BWCC32.DLL if you are running 32-bit applications. By default, BWCC is 
enabled. To disable BWCC, set enable to FALSE. 

See also: TDialog 

void EnableCtl3d(B00L enable = TRUE); 

Enables or disables the use of the CTL3D DLL. If enable is TRUE, 
EnableCtl3d loads and registers the CTL3D.DLL if it's not already enabled. 

See also: TApplication: :Ctl3dEnabled 

EnableCtl3dAutOSUDClass void EnableCtBdAutosubclass (BOOL enable); 

Enables or disables CTL3D's use of autosubclassing if CTL3D is already 
enabled using CtBdEnabled. If autosubclassing is enabled, any 
non-ObjectWindows dialog boxes have a 3-D effect. The common dialog 
classes and TDocManager use this function to turn on autosubclassing 
before creating a non-ObjectWindows dialog box to make it three- 
dimensional and to turn off autosubclassing immediately after the dialog 
box is destroyed. 



EnableCtl3d 



EndModal 



See also: TDialog: :EvCtlColor 

void EndModal (int result); 
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Find 



GetDocManager 



TApplication class 



EndModal is called to end a modal window's modal message loop. It uses 
the BreakMessageLoop flag to break the message loop and calls 
MessageLoopResult to pass the result. 

BOOL Find(TEventInfo &, TEqualOperator = 0); 

Calls TDocManager to handle events. Delegates events as needed to the 
document manager. 

See also: TDocManager:: Application 

inline TDocManager* GetDocManager ( ) const; 

Returns a pointer to the document manager object that invoked the 
application. 

See also: T Application: :SetDocManager 
GetMainWindow inline TFrameWindow* GetMainWindow(TFrameWindow* window) ; 

Returns a pointer to the application's main window. 

See also: T Application: :SetMainWindow 

GetWlnMainParams inline void GetWinMainParams ( ) ; 

GetWinMainParams initializes a static instance of an application. 
ObjectWindows OwlMain uses this function to support static application 
instances. 

See also: TApplication: :SetWinMainParams 

MessageLoop virtual int MessageLoopO; ' 

Operates the application's message loop, which runs during the lifetime of 
the application. Queries Windows for messages; if one is received, 
MessageLoop processes it by calling ProcessAppMsg. If the query returns 
without a message, MessageLoop calls IdleAction to perform some processing 
during the idle time. MessageLoop calls PumpWaitingMessages to get and 
dispatch waiting messages. MessageLoop can be broken if BreakMessageLoop 
is set by EndModal. 

See also: T Application: -.Idle Action, TApplication: -.ProcessAppMsg 

PostDispatchAction void PostDispatchActionO ; 

If T Application's message loop is not used, this function should be called 
after each message is dispatched 

PreProcessMenu virtual void PreProcessMenu(HMENU hmenu) ; 

Your application can call PreProcessMenu to process the main window's 
menu before it is displayed. 
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TApplication class 



See also: TDocmanager::EvPreProcessMenu, TMenu::TMenu 

ProcessAppMsg virtual BOOL ProcessAppMsg(MSG& msg) ; 

Checks for any special processing that is required for modeless dialog box, 
accelerator, and MDI accelerator messages. Calls the virtual 
TWindow::PreProcessMsg function of the window receiving the message. If 
your application does not create modeless dialog boxes, does not respond 
to accelerators, and is not an MDI application, you can improve 
performance by overriding this member function to return FALSE. 

See also: T Window: :PreProcessMsg 

PumpWaitingMessages BOOL PumpWaitingMessages (); 

Called by MessageLoop, PumpWaitingMessages processes and dispatches all 
waiting messages until the queue is empty. It also sets BreakMessageLoop 
when a WM_QUIT message is received. 

QueryThrow inline int QueryThrow ( ) ; 

QueryThrow tests to see if an exception is suspended and returns one or 
more of the bit flags in the xs exception status enum. 

See also: xs exception status enum 

ResumeThrow void ResumeThrow () ; 

ResumeThrow checks and rethrows suspended exceptions. Call this function 
any time you reenter ObjectWindows code from exception-unsafe code 
where an exception could have been thrown. 

Run virtual int Run() ; 

Initializes the instance, calling Init Application for the first executing instance 
and Initlnstance for all instances. If the initialization is successful, Run calls 
MessageLoop and runs the application. If exceptions are thrown outside the 
message loop, Run catches these exceptions. 

If an error occurs in the creation of a window, Run throws a TXWindow 
exception. If Status is assigned a nonzero value (which ObjectWindows 
uses to identify an error), a TXCompatibility exception is thrown. 

See also: TApplication: :Init Application, TApplication::InitInstance, 
TApplication: MessageLoop 

SetDocManager TFrameWindow* SetDocManager ( TDocManager* docManager) ; 

Sets a pointer to the document manager object that invoked the application. 

See also: TApplicationr.GetDocManager 

SetMainWindOW TFrameWindow* SetMainWindow (TFrameWindow* window); 
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TApplication class 



SetWinMainParams 



SuspendThrow 
SuspendThrow 
SuspendThrow 
SuspendThrow 



Sets up a new main window and sets the WM_MAINWINDOW flag so that 
the application knows this is the main window. 

See also: T Application: :GetMainWindow 

inline static void SetWinMainParams (HINSTANCE instance, HINSTANCE 

prevlnstance, const char far* cmdLine, 
int cmdShow) ; 

ObjectWindows default WinMain function calls SetMainWinParams so that 
TApplication can store the parameters for future use. To construct an 
application instance, WinMain calls the OwlMain function that's in the user's 
code. As it's being constructed, the application instance can fill in the 
parameters using those set earlier by SetMainWinParams. 

See also: TApplication: :GetWinMainParams 

void SuspendThrow (xalloc& x) ; 

This version of SuspendThrow saves xalloc exception information. 

void SuspendThrow (xmsg& x) ; 

This version of SuspendThrow saves xmsg exception information. 

void SuspendThrow (TX0wl& x) ; 

This version of SuspendThrow saves a copy of a TXOwl exception. 

void SuspendThrow ( int ) ; 

This version of SuspendThrow sets the xs exception status bit flags to the 
specified exception, for example Badjoast or Badjtypeid. 

See also: xs exception status enum 

Protected data members 



BreakMessageLoop BOOL BreakMessageLoop; 

Causes the current modal message loop to break and terminate. If the 
current modal message loop is the main application, and your program sets 
BreakMessageLoop, your main application terminates. 

See also: T Application: :EndModal, TApplication: :MessageLoop, 
T Application: :PumpWaitingMessages 

MessageLoopResult int MessageLoopResult; 

MessageLoopResult is set by a call to EndModal. It contains the value that is 
returned by MessageLoop and BeginModal. 
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See also: TApplicationr.BeginModal, TApplication: :EndModal, 
TApplication: -MessageLoop 

Protected member functions 



IdleAction 



InitApplication 



Initlnstance 



virtual void BOOL IdleAction (long idleCount) ; 

ObjectWindows calls IdleAction when no messages are waiting to be 
processed. You can override IdleAction to do background processing. The 
default action is to give the main window a chance to do idle processing as 
long as IdleAction returns TRUE. idleCount specifies the number of times 
IdleAction has been called between messages. 

See also: TFrameWindowr.IdleAction 

virtual void InitApplication () ; 

ObjectWindows calls InitApplication to initialize the first instance of the 
application. For subsequent instances, this member function is not called. 

The following sample program calls InitApplication the first time an instance 
of the program begins. 

class TTestApp : public TApplication { 
public: 
TTestAppO: TApplication ( "Instance Tester") 

{strcpy(WindowTitle, "Additional Instance");} 

protected: 

char WindowTitle[20]; 



void InitApplication () {strcpy(WindowTitle, "First Instance");} 

void InitMainWindowO {MainWindow = new TFrameWindow ( , WindowTitle) ; } 



}; 



static TTe'stApp App; 

virtual void Initlnstance () ; 

Performs each instance initialization necessary for the application. Unlike 
InitApplication, which is called for the first instance of an application, 
Initlnstance is called whether or not there are other executing instances of 
the application. Initlnstance calls InitMainWindow, and then creates and 
shows the main window element by TWindowr.Create and TWindowr.Shozv. 
If the main window can't be created, a TXInvalidMainWindow exception is 
thrown. 
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^^ If you redefine this member function, be sure to explicitly call 
TApplication: -.Initlnstance. 

See also: T Application: :Init Application, TApplication: :InitMainWindow, 
TApplicationr.Run, TModule::MakeWindow, TWindowr.Show 

InitMainWindow virtual void mi tMainwindowO; 

By default, InitMainWindow constructs a generic TFrameWindow object with 
the name of the application as its caption. You can redefine InitMainWindow 
to construct a useful main window object of TFrameWindow (or a class 
derived from TFrameWindow) and store it in MainWindow. The main 
window must be a top-level window; that is, it must be derived from 
TFrameWindow. A typical use is 

virtual void TMyApp: : InitMainWindow! ) { 

MainWindow = new TMyWindow(NULL, Caption) ; 
} 

InitMainWindow can be overridden to construct a useful application. 

Termlnstance virtual int Termlnstance(int status); 

Handles the termination of each executing instance of an ObjectWindows 
aplication. 



T Application ::TXInvalidMainWindow class 



applicat.h 



Constructor 



A nested class, TXInvalidMainWindow describes an exception that results 
from an invalid Window. This exception is thrown if there is not enough 
memory to create a window or a dialog object. Initlnstance throws this 
exception if it can't initialize an instance of an application object. 

Public constructors 

TXInvalidMainWindow () ; 

Constructs a TXInvalidMainWindow object with a default 
IDSJNVALIDMAINWINDOW message. 



Public member functions 



Clone 



virtual TXOwl* Clone I 
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Throw 



Makes a copy of the exception object. Clone must be implemented in any 
class derived from TXOwl. 

virtual void Throw(); 

Throws the exception object. Throw must be implemented in any class 
derived from TXOzvl. 



TBandlnfo class 



dc.h 



An ObjectWindows struct equivalent to BANDINFOSTRUCT, TBandlnfo is 
used to pass information to a printer driver that supports banding. 
TBandlnfo is declared as follows: 

struct TBandlnfo { 

BOOL HasGraphics; 

BOOL HasText; 

TRect GraphicsRect; 
}; 

HasGraphics is TRUE if graphics are (or are expected to be) on the page or in 
the band; otherwise, it is FALSE. HasText is TRUE if text is (or is expected to 
be) on the page or in the band; otherwise, it is FALSE. GraphicsRect defines 
the bounding region for all graphics on the page. 

See also: TPrintDCr.Bandlnfo, TPrintDCr.NextBand 



TBitmap class 



gdiobjec.h 



Constructor 



TBitmap is the GDI bitmap class derived from TGdiObject. TBitMap can 
construct a bitmap from many sources. TBitmap objects are DDBs (device- 
dependent bitmaps), which are different from the DIBs (device- 
independent bitmaps) represented by TDib objects. 

Public constructors 

TBitmap (HBITMAP handle, TAutoDelete autoDelete = NoAutoDelete) ; 

Creates a TBitmap object and sets the Handle data member to the given 
borrowed handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle will not be deleted when the C++ object 
is destroyed. 

See also: TGdiObjectr.Handle, TGdiObject:: ShouldDelete 
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Constructor TBitmap (const TClipboardk clipboard); 

Creates a TBitmap object with values from the given Clipboard. 

See also: TClipBoard::GetClipboardData 
Constructor TBitmap ( const TBitmapk bitmap); 

Creates a copy of the given bitmap object. 

See also: TBitmap <::GetObject, ::CreateCompatibleBitmap, r.CreateBitmap 

Constructor TBitmap (int width, int height, BYTE planes, BYTE bitCount = 1, 

void far* bits = 0) ; 

Creates a bitmap object from bitCount bits in the bits buffer with the given 
width, height, and planes argument values. 

See also: r.CreateBitmap 

Constructor TBitmap (const BITMAP far* bitmap); 

Creates a bitmap object with the values found in the given bitmap structure. 
See also: r.CreateBitmapIndirect, struct BITMAP 

Constructor TBitmap(const TDC& Dc, int width, int height, BOOL discardable = FALSE); 

Creates a bitmap object for the given device context with the given 
argument values. 

See also: ::CreateDiscardableBitmap, TDC 

Constructor TBitmap (const TDC& Dc, const TDibk dib, DWORD usage = CMB_INIT) ; 

Creates a bitmap object for the given device context with the given dib and 
usage argument values. 

See also: ::CreateDIBBitmap, TDC, TDib 

Constructor TBitmap (const TMetaFilePictfc metaFile, TPalette& palette, 

const TSize& size); 

Creates a bitmap object from the given metaFile, using the given palette and 
size arguments. 

See also: TPalette 

Constructor TBitmap (const TDib& dib, const TPalette* palette = 0); 

Creates a bitmap object from the given dib and palette arguments. A 
working palette constructed from the DIB's color table is used if no palette 
is supplied. The default system palette can also be passed using 
&TPalette::GetStock(TPalette::Default); 
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Constructor 



See also: TScreenDC::RealizePalette, ::CreateDIBBitmap, TDib 

TBitmap (HINSTANCE instance, TResID resID) ; 

Creates a bitmap object for the given application instance from the given 
resource. 

See also: r.LoadBitmap 



Public member functions 



BitsPixel BYTE BitsPixelO const; 

Returns the number of bits per pixel in this bitmap. 

See also: TBitmapr.GetObject 
GetBitmapBitS inline DWORD GetBitmapBits(DWORD count, void far* bits) const; 

Copies up to count bits of this bitmap to the buffer bits. 

See also: r.GetBitmapBits, TBitmapr.GetObject, 

GetBitmapDimension i n ii n e BOOL GetBitmapDimension(TSize& size) const; 

Retrieves the size of this bitmap (width and height, measured in tenths of 
millimeters) and sets it in the size argument. Returns TRUE if the call is 
successful; otherwise returns FALSE. 

See also: r.GetBitmapDimensionEx, TBitmapr.SetBitmapDimension, TSize 

inline BOOL GetObject (BITMAP far& bitmap) const; 

Retrieves data (width, height, and color format) for this bitmap and sets it 
in the given BITMAP structure. To retrieve the bit pattern, use 
GetBitmapBits. 

See also: TBitMap: -GetBitmapBits, struct BITMAP 

int Height () const; 

Returns the height of this bitmap. 

See also: TBitmapr.GetObject 

inline TClipboard& operator«(TClipboard& clipboard, TBitmap& bitmap); 

Copies the given bitmap to the given clipboard argument. Returns a reference 
to the resulting Clipboard, which allows normal chaining of «. 

inline operator HBITMAP() const; 



GetObject 



Height 



operator« 



operator 
HBITMAP() 
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Typecasting operator. Converts this bitmap's Handle to type HBITMAP (the 
Windows data type representing the handle to a physical bitmap). 

P'anes BYTE Planes () const; 

Returns the number of planes in this bitmap. 

See also: TBitmapr.GetObject 

SetBitmapBitS inline DWORD SetBitmapBits (DWORD count, const void far* bits); 

Copies up to count bits from the bits buffer to this bitmap. 
See also: r.GetBitmapBits 

SetBitmapDimension inline BOOL SetBitmapDimension( const TSize& size, TSize* oldSize=0); 

Sets the size of this bitmap from the given size argument (width and height, 
measured in tenths of millimeters). The previous size is set in the oldSize 
argument. Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: ::SetBitmapDimensionEx, TBitmapr.GetBitmapDimension, TSize 
ToClipboard void ToClipboard(TClipboard& clipboard); 

Copies this bitmap to the given Clipboard. 

See also: TClipboard::SetCHpboardData 
Width int Width () const; 

Returns the width of this bitmap. 

See also: TBitmapr.GetObject 

Protected member functions 



HandleCreate 



void HandleCreate (const TDib& dib, const TPalette kpalette) 
void HandleCreate (const TBitmap &src) ; 

Creates a bitmap handle from the given argument objects. 



TBitmapGadget class 



bitmapga.h 



Derived from TGadget, TBitmapGadget is a simple gadget that can display an 
array of bitmap images one at a time. 
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Public constructors and destructor 



Constructor 



Destructor 



TBitmapGadget (TResId bmpResId, int Id, TBorderStyle borderStyle, 
TResId bitmapName, int numlmages, int startlmage) ; 

Constructs a TBitmapGadget and sets the current image to the beginning 
image in the array of images. Then, sets the border style to the current 
TGadget border style and numlmages to the number of images in the array. 

-TBitmapGadget () ; 

Deletes the array of images. 



Selectlmage 



Public member functions 



int Selectlmage (int imageNum, BOOL immediate); 

Determines the current image and repaints the client area if the image has 
changed. Calls the Windows API function : -.Update Window to update the 
client area if the image has changed. 



SysColorChange void SysColorChange 



When the system colors have been changed, SysColorChange is called by the 
gadget window's EvSysColorChange so that bitmap gadgets can be rebuilt 
and repainted. 

Protected member functions 



GetDesiredSize 



Paint 



SetBounds 



void GetDesiredSize (TSize& size); 

Calls TGadget::GetDesiredSize, which determines how big the bitmap gadget 
can be. The gadget window sends this message to query the gadget's size. If 
shrink-wrapping is requested, GetDesiredSize returns the size needed to 
accommodate the borders and margins. If shrink-wrapping is not 
requested, it returns the gadget's current width and height. TGadgetWindozv 
needs this information to determine how big the gadget needs to be, but it 
can adjust these dimensions if necessary. If WideAsPossible is TRUE, then 
the width parameter (size.cx) is ignored. 

void Paint (TDC& dc); 

Paints the gadget's border and the contents of the bitmap. 

void SetBounds (TRect& r) ; 
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Calls TGadget::SetBounds and passes the dimensions of the bitmap gadget. 
SetBounds informs the control gadget of a change in its bounding rectangle. 

See also: TGadget:: SetBounds 



TBitSet class 



bitset.h 



TBit Set sets or clears a single bit or a group of bits. You can use this class to 
set and clear option flags and to retrieve information about a set of bits. The 
class TCharSet performs similar operations for a string of characters. 



Constructor 



Constructor 



Disableltem 

Disableltem 

Enableltem 

Enableltem 

Has 

IsEmpty 

operator += 



Constructors 



TBitSet (); 

Constructs a TBitSet object. 

TBitSet (const TBitSet& bs); 

Constructs a TBitSet object as a copy of another TBitSet. 



Public member functions 



void Disableltem (int item); 

Clears a single bit at item. 

void DisableItem(const TBitSet& bs) ; 

Clears the set of bits enabled in bs. 

void Enableltem (int item); 

Sets a single bit at item. 

void Enableltem (const TBitSetk bs); 

Sets the set of bits enabled in bs. 

int Has (int item) ; 

Is nonzero if item is in the set of bits. 

int TBitSet: : IsEmpty () ; 

Is nonzero if the set is empty; otherwise, is 0. 

inline TBitSet& operator +=(int item); 
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Calls Enableltem to set a bit in the copied set. Returns a reference to the 
copied TBitSet object. 

operator += inline TBitSetk operator += (const TBitSetk bs) ; 

Calls Enableltem to set the bits enabled in bs. Returns a reference to the 
copied TBitSet object. 

operator -= inline TBitSet& operator -=(int item); 

Calls Disableltem to clear a bit in the set. Returns a reference to the copied 
TBitSet object. 

operator -= inline TBitSet& operator -= (const TBitSet& bs); 

Calls Disableltem to clear the bits enabled in bs. Returns a reference to the 
copied TBitSet object. 

operator &= TBitSet& operator &= (const TBitSet&); 

ANDs all of the bits in the copied set and returns a reference to the copied 
TBitSet object. 

operator^ TBitSet& operator I = (const TBitSet&) ; 

ORs all of the bits in the copied set and returns a reference to the copied 
TBitSet object. 

operator- TBitSet operator -(const TBitSet&) ; 

Returns the set of bits that is the opposite of a specified set of bits. For 
example, if the set of bits is 01010101, the returned set is 10101010. Returns 
a reference to the copied TBitSet object. 



TBrush class 



gdiobjec.h 



The GDI Brush class is derived from TGdiObject. TBrush provides 
constructors for creating solid, styled, or patterned brushes from explicit 
information. It can also create a brush indirectly from a borrowed handle. 

Public data members 



enum Stockld 



enum TStockId{Null, Black, DkGray, Gray, LtGray, White}, 
Enumerates the attributes of the stock brush objects. 
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Protected data members 



Stocks[ ] 

Note: This array no 

longer exists. Use 

TDC::SelectStockObject 

instead. 



static TBrush Stocks []; 

The single static array of Windows stock pen objects serving all TBrush 
objects. The stock brushes are NULL_BRUSH, BLACK_BRUSH, 
DK_GRAY_BRUSH, GRAYJBRUSH, LTGRAY_BRUSH, and 
WHITE BRUSH. 



Public constructors 



Constructor 



Constructor 



Constructor 



Constructor 



Constructor 



TBrush (HBRUSH handle, TAutoDelete autoDelete = NoAutoDelete) ; 

Creates a TBrush object and sets the Handle data member to the given 
borrowed handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle will not be deleted when the C++ object 
is destroyed. 

See also: TGdiObject "Handle, TGdiObject:: ShouldDelete 

TBrush (TColor color) ; 

Creates a solid TBrush object with the given color. Sets Handle via a Win 
API CreateSolidBrush(color) call. To save a brush creation, this constructor 
uses a cache that can detect any color that matches a stock color. 

See also: ::CreateSolidBrush, TColor 

TBrush(TColor color, int style); 

Creates a hatched TBrush object with the given style and color. Sets Handle 
via a Win API CreateHatchedBrush(style, color) call. 

See also: ::CreateHatchedBrush, ::CreateHashBrush, TColor 

TBrush (const TBitmap& pattern); 

Creates a patterned TBrush object with the given pattern. Sets Handle via a 
Win API CreatePatternBrush(pattern) call. 

See also: ::CreatePatternBrush 

TBrush (const TDib& pattern); 

Creates a patterned TBrush object with the given DIB pattern. Sets Handle 
via a Win API CreateDIBPatternBrush(pattern, pattern. .usageO) call or the 
Win32 API CreateDIBPatternBrushPt(pattern, pattern. .usageO) call. 

See also: ::CreateDIBPatternBrushPt, ::CreateDIBPatternBrush 
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Constructor . TBrush (const LOGBRUSH far* logBrush) ; 

Creates a TBrush object with values from the given logBrush. Sets Handle via 
a Win API CreateBrushlndirect(logBrush) call. 

See also: ::CreateBrushIndirect 



GetObject 



operator 
HBRUSH() 



UnrealizeObject 



Public member functions 

inline BOOL GetObject (LOGBRUSH far& logBrush) const; 

Retrieves information about this brush object and places it in the given 
LOGBRUSH structure. Returns TRUE if the call is successful; otherwise 
returns FALSE. 

See also: TGdiObject::GetObject, struct LOGBRUSH 

inline operator HBRUSH() const; 

Typecasting operator. Converts this brush's Handle to type HBRUSH (the 
Windows data type representing the handle to a physical brush). 

BOOL UnrealizeObject (); 

Directs the GDI to reset the origin of this brush the next time it is selected. 
Returns TRUE if call is successful; otherwise returns FALSE. 

See also: "UnrealizeObject 



TButton class 



button.h 



TButton is an interface class that represents a push-button interface element 
in Windows. You must use a TButton to create a button control in a parent 
T Window. You can also use a TButton to facilitate communication between 
your application and the button controls of a TDialog. This class is 
streamable. 

There are two types of push buttons: regular and default. Regular buttons 
have a thin border. Default buttons (which represent the default action of 
the window) have a thick border. 



48 



ObjectWindows 2.0 Reference Guide 



TButton class 



Public data members 



IsDefPB 



Constructor 



Constructor 



BOOL IsDefPB; 

Indicates whether the button is to be considered the default push button. 
Used for owner-draw buttons, IsDefPB is set by a TButton constructor based 
on BS_DEFPUSHBUTTON style setting. 

Public constructors 

TButton (Window *parent, int Id, const char far *text, int X, int Y, int W, 
int H, BOOL isDefault = FALSE, TModule* module = 0); 

Constructs a button object with the supplied parent window (parent), 
control ID (Id), associated text (text), position (X, Y) relative to the origin of 
the parent window's client area, width ( W), and height (H). If IsDefault is 
TRUE, the constructor adds BS_DEFPUSHBUTTON to the default styles set 
for the TButton (in Attr.Style). Otherwise, it adds BS_PUSHBUTTON. 

See also: TControlr.TControl 

TButton (TWindow *parent, int resID, TModule* module = 0); ■ 

Constructs a TButton object to be associated with a button control of a 
TDialog. Calls DisableTransfer to exclude the button from the transfer 
mechanism because there is no data to be transferred. 

The resld parameter must correspond to a button resource that you define. 

See also: TControlr.TControl 



Protected data members 

IsCurrentDefPB bool IsCurrentDefPB; 

Indicates whether the current button is the default push button. 

Protected member functions 



BMSetStyle 



LRESULT BMSetStyle(WPARAM, LPARAM) ; 

Because a button can't have both owner-drawn and push button styles, 
BMSetStyle keeps track of the style if the button is owner-drawn and 
Windows tries to set the style to BS_DEFPUSHBUTTON. BMSetStyle sets 
IsCurrentDefPB to TRUE if the button style is BS_DEFPUSHBUTTON. 



Chapter 1, Library reference 



49 



TButton class 



EvGetDlgCode UINT EvGetDlgCode (MSG far*) ; 

Responds to WM_GETDLGCODE messages from the dialog manager. For 
owner-drawn buttons, EvDlgCode returns a code that indicates whether the 
button is the default button. 

See also: TControl 
GetClassName char far* GetClassNameO; 

Returns the name of TButton's Windows registration class, "BUTTON." 

SetupWindOW void SetupWindow ( ) ; 

If the button is the default push button and an owner-drawn button, 
SetupWindow sends a DM_SETDEFID message to the parent window. 



Response table entries 






Response table entry 


Member function 


EV_WM_GETDLGCODE 

EV_MESSAGE (BM_SETSTYLE, BMSetStyle) 


EVGetDlgCode 
BMSetStyle 



TButtonGadget class 



buttonga.h 



Derived from TGadget, TButtonGadgets represent buttons that you can click 
on or off. You can also apply attributes such as color, style, and shape 
(notched or unnotched) to your button gadgets. 

In general, button gadgets are classified as either command or attribute 
buttons. Attribute buttons include radio buttons (which are considered 
exclusive), or check boxes (which are nonexclusive). The public data 
member, TType, enumerates these button types. 

TButtonGadget objects respond to mouse events in the following manner: 
when a mouse button is pressed, the button is pressed; when the mouse 
button is released, the button is released. Commands can be entered only 
when the mouse button is in the "up" state. When the mouse is pressed, 
TButtonGadget objects capture the mouse and reserve all mouse messages 
for the current window. When the mouse button is up, button gadgets 
release the capture for the current window. The public data member, 
TState, enumerates the three button states. 
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Public data members 



TShadowStyle 
enum 



TState enum 



TType enum 



enum TShadowStyle; 

Enumerates button shadow styles — either single (1) or double (2) shadow 
borders. 

enum TState; 

TState enumerates the three button positions during which the button can 
be pressed: up (0), down (1), and an indeterminate state (2). A nonzero 
value indicates a highlighted button. 

enum TType; 

Enumerates the types of buttons: command, exclusive, or nonexclusive. 



Public constructors and destructor 



Constructor 



Destructor 



TButtonGadget (TResId uiBitmap, int id, TType type = Command, 
BOOL enabled = FALSE, TState state = Up, • 
BOOL repeat = FALSE) ; 

Constructs a TButtonGadget object using the specified bitmap ID, button 
gadget ID, and type, with the button enabled and in a button-up state. 

See also: TButtonGadget: -.State 

-TButtonGadget ( ) ; 

Deconstructs a TButtonGadget object. 



CommandEnable 



GetButtonState 



Public member functions 



void CommandEnable ( ) ; 

Enables the button gadget to capture messages. Calls SendMessage to send a 
WM_COMMAND_ENABLE message to the gadget window's parent, 
passing a TCommandEnable: EvCommandEnable message for this button. 

inline TState GetButtonState (); 

Returns the state of the button. If 0, the button is up, if 1, the button is 
down, if 2, the state is indeterminate. 



See also: TButtonGadgetr.State 
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GetButtOtlType inline TType GetButtonTypeO ; 

Returns the button type as 1 if the button is a command, 2 if exclusive, or 3 
if nonexclusive. 

SetButtOnState void SetButtonState(TState); 

Sets the state of the button. If the state has changed, the button is exclusive, 
and is in the down state, checks that the button is exclusive, sets State, and 
calls Invalidate to mark the changed area of the gadget for repainting. 

See also: TButtonGadgetr.State 

SetNotchCorners void SetNotchCorners (BOOL); 

By default, SetNotchCorners implements notched corners for buttons. To 
repaint the frame of the button if the window has already been created, call 
InvalidateRect with the Bounds rectangle. 

See also: TButtonGadget: -.Invalidate, TGadget: -.InvalidateRect, TGadget::Paint 

SetShadOwStyle void SetShadowStyle(TShadowStyle) ; 

Sets the button style to a shadow style which, by default, is DoubleShadow. 
Sets the left and top borders to 2 and the right and bottom borders to 
ShadowStyle + 1. 

SysColorChange void SysColorChangeO ; 

SysColorChange responds to an EvSysColorChange message forwarded by the 
owning TGadgetWindow by setting the dither brush to zero. If a user- 
interface bitmap exists, SysColorchange deletes and rebuilds it to get the new 
button colors. 

Protected data members 



BitmapOrigin TPoint BitmapOrigin; 

Points to the x and y coordinates of the bitmap used for this button gadget. 

NotChComers UINT NotchCorners; 

Initialized to 1, NotchCorners is 1 if the button gadget has notched corners 
or if it doesn't have notched corners. 

Pressed UINT Pressed; 

Initialized to 1, Pressed is 1 if the button is released or if it isn't released. 
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Repeat 

Resld 

ShadowStyle 
State 

Type 

UIBitmap 



See also: TButtonGadget:: Activate, TButtonGadget r.BeginPressed, 
TButtonGadget: -.CancelPressed 

UINT Repeat; 

Initialized to 1, Repeat stores the repeat count for keyboard events. 

TResId Resld; 

Holds the resource ID for this button gadget's bitmap. 

TShadowStyle ShadowStyle; 

Holds the shadow style for the button — 1 for single and 2 for double. 

TState State; 

Holds the state of the button — either up, down, or indeterminate. 

TType Type; 

Holds the type of the button — either command, exclusive, or nonexclusive. 

TUIBitmap *UIBitmap; 

Holds the bitmap associated with the button gadget. 



Protected member functions 



Activate 



BeginPressed 



CancelPressed 



virtual void Activate (TPointk p) ; 

Invoked when the mouse is in the "up" state, Activate sets Pressed to 
FALSE, changes the state for attribute buttons, and paints the button in its 
current state. To do this, it calls CancelPressed, posts a WM_COMMAND 
message to the gadget window's parent, and sends menu messages to the 
gadget window's parent. 

See also: TButtonGadget::Pressed 

virtual void BeginPressed (TPointk p) ; 

When the mouse button is pressed, Beginpressed sets Pressed to TRUE, 
paints the pressed button, and sends menu messages to the gadget 
window's parent. 

See also: TButtonGadget: -.Pressed 

virtual void CancelPressed(TPoint& p) ; 

When the mouse button is released, CancelPressed sets Pressed to FALSE, 
paints the button, and sends menu messages to the gadget window's 
parent. 
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GetDesiredSize 



Invalidate 



LButtonDown 



LButtonUp 



MouseMove 



Paint 



See also: TButtonGadget -.-.Pressed 

void GetDesiredSize (TSize& size); 

Stores the width and height (measured in pixels) of the button gadget in 
size. Calls TGadget's GetDesiredSize to calculate the relationship between one 
rectangle and another. 

void Invalidate () ; 

If a button is pressed or the state of the button is changed, Invalidate 
invalidates (marks for repainting) the changed area of the gadget. Invalidate 
only invalidates the area that changes. To repaint the entire gadget, call 
TGadget::InvalidateRect and pass the rectangle's boundaries. 

See also: TButtonGadget:: State, TGadget::InvalidateRect 

void LButtonDown (UINT modKeys, TPoint& p) ; 

Overrides TGadget member function and responds to a left mouse button 
click by calling BeginPressed. 

See also: TButtonGadgetr.BeginPressed 

void LButtonUp (UINT modKeys, TPoint& p) ; 

Overrides TGadget member functions and responds to a release of the left 
mouse button by calling Activate. 

See also: TButtonGadget:: Activate 

void MouseMove (UINT modKeys, TPointk p) ; 

Calls TGadget -.-.MouseMove in response to the mouse being dragged. If the 
mouse moves off the button, MouseMove calls CancelPressed. If the mouse 
moves back onto the button, MouseMove calls BeginPressed. 

See also: TButtonGadgetr.BeginPressed, TButtonGadgetr.CancelPressed 

void Paint (TDC& dc) ; 

Calls ::GetSystemMetrics to get the width and height of the window frame 
(in pixels), calls GetlmageSize to retrieve the size of the bitmap, and sets the 
inner rectangle to the specified dimensions. Calls TGadget ::PaintBorder to 
perform the actual painting of the border of the control. Before painting the 
control, Paint determines whether the corners of the control are notched, 
and then calls GetSysColor to see if highlighting or shadow colors are used. 
Paint assumes the border style is plain. Then, Paint draws the top, left, 
right, and bottom of the control, adjusts the position of the bitmap, and 
finishes drawing the control using the specified embossing, fading, and 
dithering. 
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TButton Gadget class 



SetBounds 



void SetBounds (TRect& r) ; 

Gets the size of the bitmap, calls TGadget::SetBounds to set the boundary of 
the rectangle, and centers the bitmap within the button's rectangle. 

See also: TGadget:: SetBounds 



TCelArray class 



celarray.h 



TCelArray is a horizontal array of eels (a unit of animation) created by 
slicing a portion of or an entire bitmap into evenly sized shapes. Gadgets 
such as buttons can use a TCelArray to save resource space. TCelArray's 
functions let you control the dimensions of each eel and determine if the eel 
can delete the bitmap. 

Offset from the top left corner of the bitmap 

<-— Bitmap 






1 


2 


3 


4 



Number of cells 



Public constructors and destructor 



Constructor 



Constructor 



Constructor 



TCelArray (TBitmap* bmp, int numCels, TSize celSize 
TAutoDelete = AutoDelete) ; 



TPoint Offset = 



Destructor 



Constructs a TCelArray from a bitmap by slicing the bitmap into a 
horizontal array of eels of a specified size. If autoDelete is TRUE, TCelArray 
can automatically delete the bitmap. The ShouldDelete data member defaults 
to TRUE, ensuring that the handle will be deleted when the bitmap is 
destroyed. 

TCelArray (TDib& dib, int numCels); 

Constructs a TCelArray from a DIB (Device Independent Bitmap) by slicing 
the DIB into a horizontal array of evenly sized eels. 

TCelArray (const TCelArrayk sre); 

Constructs a TCelArray as a copy of an existing one. If the original 
TCelArray owned its bitmap, the constructor copies this bitmap; otherwise, 
it keeps a reference to the bitmap. 

virtual -TCelArray ( ) ; 
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CelSize 
CelOffset 

CelRect 

NumCels 
Offset 
operator [] 
operator = 



operator 
TBitmap& 

SetCelSize 



SetOffset 



SetNumCels 



If ShouldDelete is TRUE (the default value), the bitmap is deleted. If 
ShouldDelete is FALSE, no action is taken. 

Public member functions 

inline TSize CelSize () const; 
Returns the size in pixels of each cell. 

inline TPoint CelOffset (TPoint offs); 

Returns the position of the upper left corner of a given eel relative to the 
upper left corner of the bitmap. 

TRect CelRect (int eel) const; 

Returns the upper left and lower right corner of a given cell relative to the 
upper left corner of the bitmap. 

inline int NumCels () const; 

Returns the number of eels in the array. 

int Offset () const; 

Returns the offset of the entire CelArray. 

inline TRect operator [] (int eel) const; 
Returns CelRect. 

TCelArrayk operator = (const TCelArray&) ; 
Returns TCelArray. 
inline operator TBitmap&(); 
Returns a reference to the bitmap. 
inline void SetCelSize (TSize size); 
Sets the size of each eel in the array. 
inline void SetOffset (TPoint offs); 
Sets the offset for the eels in the array. 
inline void SetNumCels (int numCels) ; 
Sets the number of eels in the array. 
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Protected data members 



Bitmap 



CSize 



Offs 



NCels 



ShouldDelete 



TBitmap* Bitmap; 

Points to the bitmap. 

TSize CSize; 

The size of a cell in the array. 

TPoint Offs; 

Holds the offset of the upper left corner of the eel array from the upper left 
corner of the bitmap. 

int NCels; 

The number of cells in the eel array. 

BOOL ShouldDelete; 

Is TRUE if the destructor needs to delete the bitmap associated with the eel 
array. 



TCharSet class 



bitset.h 



Derived from TBitSet, TCharSet sets and clears bytes for a group of 
characters. You can use this class to set or clear bits in a group of characters, 
such as the capital letters from "A" through "Z" or the lowercase letters 
from "a" through "z." The class TBitSet performs similar operations for a 
group of bits. 

Public constructors 



Constructor 



Constructor 



Constructor 



TCharSet ( ) ; 

Constructs a TCharSet object. 

TCharSet (const TCharSet&) ; 

Copy constructor for a TCharSet object. 

TCharSet (const char far* str) ; 

Constructs a string of characters. 
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Public member functions 



operator != 



inline int operator != (const TBitSetk bsl, const TBitSetk bs2); 

ORs all of the bits in the copied string and returns a reference to the copied 
TCharSet object. 



TCheckBox class 



checkbox.h 



See Chapter 4 in the 

ObjectWindows 

Programmer's Guide 

for a description of 

interface objects. See 

Chapter 10 in the 

ObjectWindows 

Programmer's Guide 

for specific 

instructions about 

creating check box 

controls. 



Group 



TCheckBox is a streamable interface class that represents a check box 
control. Use TCheckBox to create a check box control in a parent window. 
You can also use TCheckBox objects to more easily manipulate check boxes 
you created in a dialog box resource. 

Two-state check boxes can be checked or unchecked; three-state check boxes 
have an additional grayed state. TCheckBox member functions let you easily 
control the check box's state. A check box can be in a group box (a 
TGroupBox object) that groups related controls. 

Public data members 

TGroupBox *Group; 

If the check box belongs to a group box (a TGroupBox object), Group points 
to that object. If the check box is not part of a group, Group is zero. 

See also: TGroupBox: -.TGroupBox 

Public constructors 



Constructor 



Constructor 



TCheckBox (TWindow *parent, int Id, const char far *title, int x, int y, 
int w, int h, TGroupBox *group, TModule* module = 0) ; 

Constructs a check box object with the specified parent window {parent), 
control ID (Id), associated text (title), position relative to the origin of the 
parent window's client area (x, y), width (w), height (h), associated group 
box (group), and owning module (module). Invokes the TButton constructor 
with similar parameters. Sets the check box's Attr. Style to WS_CHILD I 
WS_VISIBLE I WS_TABSTOP I BS_AUTOCHECKBOX. 

See also: TButton: -.TButton 

TCheckBox (TWindow *parent, int resourceld, TGroupBox *group, TModule* 
module = 0) ; 
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Constructs an associated TCheckBox object for the check box control with a 
resource ID of resourceld in the parent dialog box. Sets Group to group and 
then enables the data transfer mechanism by calling EnableTransfer. 

See also: TButton::TButton, TWindow::EnableTransfer 



Public member functions 



Check 



GetCheck 



Table 1.26 

TCheckBox check 

states 



GetState 



SetCheck 



SetState 



SetStyle 



void Check () ; 

Forces the check box to be checked by calling SetCheck with the value of 
BF_CHECKED. Notifies the associated group box, if there is one, that the 
state was changed. 

See also: TCheckBox: -.GetCheck, TCheckBox: :Toggle, TCheckBox: :Uncheck, 
TGroupBox::SelectionChanged 

inline UINT GetCheck () const; 

Returns the state of the check box. 



Check box state 



Return value 



Checked 

Unchecked 

Grayed 



BF_CHECKED 
BFJJNCHECKED 
BF GRAYED 



See also: TCheckBox:: SetCheck 

inline UINT GetState () const; 

Returns the check, focus, and highlight state of the check box. See the 
BM_GETSTATE message in the Windows API online Help for more details. 

See also: TCheckBox::SetState 

void SetCheck (WORD check); 

Forces the check box into the state specified by Check. See Table 1.26 for 
possible values of Check. 

See also: TCheckBox: -.GetCheck 

inline void SetState (UINT state); 

Sets the check, focus, and highlight state of the check box. See the 
BM_SETSTATE message in the Windows API online Help for more details. 

See also: TCheckBox: -.GetState 

inline void SetStyle (UINT style, BOOL redraw); 
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Toggle 



Transfer 



Uncheck 



Changes the style of the check box. See the BM_SETSTYLE message in the 
Windows API online Help for more details. 

void Toggle () ; 

Toggles the check box between checked and unchecked if it's a two-state 
check box; toggles it between checked, unchecked, and gray if it's a three- 
state check box. 

See also: TCheckBox: :SetCheck 

virtual WORD Transfer (void *buffer, TTransferDirection direction); 

Overrides TWindow::Transfer. Transfers the check state of the check box to 
or from buffer, using the values specified in Table 1.26. If direction is 
tdGetDate, the check box state is transferred into the buffer. If direction is 
tdSetData, the check box state is changed to the settings in the transfer 

buffer. 

Transfer returns the size of the transfer data in bytes. To get the size without 
actually transferring the check box, use tdSizeData as the direction argument. 

inline void Uncheck (); 

Forces the check box to be unchecked by calling SetCheck with a value of 
BF_UNCHECKED. Notifies the associated group box, if there is one, that 
the state has changed. 

See also: TCheckBox: -.Check, TCheckBoxr.SetCheck, TCheckBox: -.Toggle 

Protected member functions 



BNCIicked 



EvGetDlgCode 



GetClassName 



void BNCIicked (); 

Responds to notification message BN_CLICKED, indicating that the user 
clicked the check box. If Group isn't 0, BNCIicked calls the group box's 
SelectionChanged member function to notify the group box that the state has 
changed. 

See also: TGroupBox::SelectionChanged 

UINT EvGetDlgCode ( ) ; 

Overrides TButton's response to the WM_GETDLGCODE message, an 
input procedure associated with a control that is not a check box, by calling 
DefaultProcessing. 

See also: TButton::EvGetDlgCode, TWindow::DefaultProcessing 

char far* GetClassName () ; 
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If BWCC is enabled, TCheckBox returns CHECK_CLASS. If BWCC is not 
enabled, returns "BUTTON." 



Response table entries 






Response table entry 


Member function 


EV_NOTIFY_AT_CHILD (BN_CLICKED, BNCIicked) 
EV_WM_GETDLGCODE 


BNCIicked 
EVGetDlgCode 



TChooseColorDialog class 



chooseco.h 



Constructor 



TChooseColorDialog objects represent modal dialog box interface elements 
that allow color selection and custom color adjustment. TChooseColorDialog 
can be made to appear modeless to the user by creating the dialog's parent 
as an invisible pop-up window and making the pop-up window a child of 
the main application window. 

Public constructors 

TChooseColorDialog (TWindow* parent, TData& data, TResId templatelD = 0, 
const char far* title = 0, TModule* module = 0); 

Constructs a dialog box with specified parent window, data, resource 
identifier, window caption, and library ID. 

See also: TChooseColorDialog: :TData 



Public member functions 



SetRGBColor inline void SetRGBColor(TColor color); 

Sets the current RGB color for the open dialog box by sending a 
SetRGBMsgld. You can use SetRGBColor to send a message to change the 
current color selection. 



Protected data members 



cc 



CHOOSECOLOR cc; 
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TChooseColorDialog class 



Data 



SetRGBMsgld 



Stores the length of the TChooseColorDialog structure, the window that owns 
the dialog box, and the data block that contains the dialog template. It also 
points to an array of 16 RGB values for the custom color boxes in the dialog 
box, and specifies the dialog-box initialization flags. This information is 
passed to the Windows API ChooseColor function. 

See also: TChooseColorDialog: :TData 

TData& Data; 

Data is a reference to the TData object passed in the constructor. 

See also: TChooseColorDialog ::TData 

static UINT SetRGBMsgld; 

Contains the ID of the registered message sent by SetRGBColor. 



Protected member functions 



DialogFunction BOOL DialogFunction(UINT message, WPARAM, LPARAM); 

Returns TRUE if a message is handled. 

See also: TDialogy.DialogFunction 

DoExecute int DoExecute () ; 

If no error occurs, DoExecute copies flags and colors into Data and returns 
zero. If an error occurs, DoExecute returns the IDCANCEL with Data.Error 
set to the value returned from CommDlgExtendedError. 

EvSetRGBColor inline LPARAM EvSetRGBColor (WPARAM, LPARAM); 

Responds to the message sent by SetRGBColor by forwarding it to the 
original class via DefaultProcessing. This event handler is not in the response 
table. 



Response table entries 



The TChooseColorDialog response table has no entries. 



TChooseColorDialog::TData struct 



chooseco.h 



The TChooseColorDialogr.TData struct defines information necessary to 
initialize the dialog box with the user's color selection. 
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TChooseColorDialog: :TData struct 



CustColors 



Error 



Public data members 



Color TColor Color; 

Color specifies the color that is initially selected when the dialog box is 
created and contains the user's color selection when the dialog box is 
closed. 

TColor* CustColors; 

CustColors points to an array of 16 colors. 

DWORD Error; 

Error contains one of the following CommDlgExtendedError codes: 

Constant Meaning 

CDERR_DIALOGFAILURE Failed to create a dialog box. 

CDERR_FINDRESFAILURE Failed to find a specified resource. 

CDERR_LOADRESFAILURE Failed to load a specified resource. 

CDERR_LOCKRESOURCEFAILURE Failed to lock a specified resource. 

CDERR_LOADSTRFAILURE Failed to load a specified string. 

Flags DWORD Flags; 

Flags can be a combination of the following Windows API constants: 
Constant Meaning 

CC_FULLOPEN Causes the entire dialog box to appear when the dialog box is 

created. 
CC_PREVENTFULLOPEN Disables the "Define Custom Colors" push button. 
CC_RGBINIT Causes the dialog box to use the color specified in rgbResult as 

the initial color selection. 
CC_SHOWHELP Causes the dialog box to show the Help push button. 

See also: TChooseColorDialog: :Data, r.ChooseColor 

TChooseFontDialog class choosefo.h 

A TChooseFontDialog represents modal dialog-box interface elements that 
create a system-defined dialog box from which the user can select a font, a 
font style (such as bold or italic), a point size, an effect (such as strikeout or 
underline), and a color. TChooseFontDialog can be made to appear modeless 
by creating the dialog's parent as an invisible pop-up window and making 
the pop-up window a child of the main application window. 
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Constructor 



See Chapter 4 in the ObjectWindows Programmer's Guide for a general 
description of interface objects and Chapter 8 in the ObjectWindows 
Programmer's Guide for specific instructions about creating dialog boxes. 

Public constructors 

TChooseFontDialog (TWindow* parent, TData& data, TResI'D templatelD = 0, 
const char far* title = 0, TModule* module = 0); 

Constructs a dialog box with specified data, parent window, resource 
identifier, window caption, and library ID. 

See also: TChooseFontDialog: :TData 



Protected data members 



cf 



Data 



CH00SEF0NT cf; 

Contains font attributes that ObjectWindows passes to the Windows API 
Choosefont function, cf is initialized using fields in the 
TChooseFontDialogr.TData class. It stores the length of the structure, the 
window that owns the dialog box and the data block that contains the 
dialog template. It also specifies the dialog-box initialization flags. 

See also: TChooseFontDialog: :TData 

TData& Data; 

Data is a reference to the TData object passed in the constructor. 

See also: TChooseFontDialog: :TData 



Protected member functions 



CmFontApply inline void CmFontApply () ; 

Default handler for the third push button (the apply button) in the dialog 
box. 

DialogFunction B 00L DialogFunction(UINT message, WPARAM, LPARAM) ; 

Returns TRUE if a message is handled. 

See also: TDialogr.DialogFunction 
DoExecute i nt DoExecuteO; 
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If no error occurs, DoExecute copies the flag values and font information 
into Ddata, and returns 0. If an error occurs, DoExecute returns the 
CommDlgExtendedError. 

See also: TChooseFontDialog::TData 

Response table entries 

The TChooseFontDialog response table contains no entries. 

TChooseFontDialog: :TData struct choosefo.h 

The ChooseFontDialog structure defines information necessary to initialize 
the dialog box with the user's font selection. 

Public data members 

Color TColor Color; 

Indicates the font color that is initially selected when the dialog box is 
created; contains the user's font color selection when the dialog box is 
closed. 

DC HDC DC- 

Handle to the device context from which fonts are obtained. 

^or DWORD Error; 

Error contains one of the following CommDlgExtendedError codes: 

Constant Meaning 

CDERFTDIALOGFAILURE Failed to create a dialog box. 

CDERR_FINDRESFAILURE Failed to find a specified resource. 

CDERR_LOCKRESOURCEFAILURE Failed to lock a specified resource. 

CDERR_LOADRESFAILURE Failed to load a specified resource. 

CDERR_l.OADSTRFAIL.URE Failed to load a specified string. 

CFERR_MAXLESSTHANMIN The size specified in SizeMax is less than the size in 

SizeMin. 

CFERRJMOFONTS No fonts exist. 

F, a9S DWORD Flags; 

Flags can be a combination of the following Windows API constants: 
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TChoose FontDialog : :TData struct 



Constant 



Meaning 



CF_APPLY 
CF_ANSIONLY 

CF_BOTH 

CF_EFFECTS 

CF_FIXEDPITCHONLY 

CF_FORCEFONTEXIST 

CF_INITTOLOGFONTSTRUCT 

CF_LIMITSIZE 

CF_NOSIMULATIONS 

CF_PRINTERFONTS 

CF_SCALABLEONLY 
CF_SCREENFONTS 

CF_SHOWHELP 

CFJTONLY 

CF_USESTYLE 

CF WYSIWYG 



Enables the display and use of the Apply button. 

Specifies that the ChooseFontDialog structure allows only the 

selection of fonts that use the ANSI character set. 

Causes the dialog box to list both the available printer and 

screen fonts. 

Enables strikeout, underline, and color effects. 

Enables fixed-pitch fonts only. > 

Indicates an error if the user selects a nonexistent font or 

style. 

Uses the LOGFONT structure at which LogFont points to 

initialize the dialog controls. 

Limits font selection to those between SizeMin and SizeMax. 

Does not allow GDI font simulations. 

Causes the dialog box to list only the fonts supported by the 

printer that is associated with the device context. 

Allows only the selection of scalable fonts. 

Causes the dialog box to list only the system-supported 

screen fonts. 

Causes the dialog box to show the Help button. 

Enumerates and allows the selection of TrueType fonts only. 

Specifies that Style points to a buffer containing the style 

attributes used to initialize the selection of font styles. 

Allows only the selection of fonts available on both the printer 

and the screen. 



LogFont 

PointSize 

Style 

FontType 

SizeMax 

SizeMin 



LOGFONT LogFont; 

Attributes of the font. 

int PointSize; 

Point size of the font. 

char far* Style; 

Style of the font such as bold, italic, underline, or strikeout. 

WORD FontType; 

Font type or name. 

int SizeMax; 

Maximum size of the font. 

int SizeMin; 

Minimum size of the font. 
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See also: TChooseFontDialog::Data 



TCIientDC class 



dc.h 



Constructor 



A DC class derived from TWindowDC, TCIientDC provides access to the 
client area owned by a window. 

Public constructors 

TCIientDC (HWND wnd); 

Creates a TCIientDC object with the given owned window. The data 
member Wnd is set to wnd. 

See also: TWindowDC:: Wnd, TDC::TDC 



TCIipboard class 



clipboar.h 



DefaultProtocol 



TCIipboard encapsulates several Windows API Clipboard functions that 
manipulate Clipboard data. You can open, close, empty, and paste data in a 
variety of data formats between the Clipboard and the open window. 

Public data members 

static const char* DefaultProtocol; 

Points to a string that specifies the name of the protocol the client needs. 
The default protocol is "StdFileEditing," which is the name of the object 
linking and embedding protocol. The macros _OLE_H or _INC_OLE must 
be defined before this function can be used. 

See also: TCIipboard: -.Query Create 



Public member functions 



CloseClipboard 



inline void CloseClipboard () 

Closes the Clipboard and returns TRUE if the Clipboard is closed or FALSE 
if it is not closed. Closing the Clipboard allows other applications to access 
the Clipboard. 

See also: TCIipboard: -.CloseClipboard, : -.CloseClipboard 
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CountClipboardFormatS inline int CountClipboardFormatsO const; 

Returns a count of the number of types of data formats the Clipboard can 
use. 

See also: TClipboard::RegisterCHpboardFormats 

EmptyClipboard inline BOOL EmptyClipboardO ; 

Clears the Clipboard and frees any handles to the Clipboard's data. Returns 
TRUE if the Clipboard is empty, or FALSE if an error occurs. 

See also: ::Empty Clipboard 

GetCHpboardData inline HANDLE GetClipboardData(UINT format) const; 

Retrieves data from the Clipboard in the format specified by format. For a 
description of Windows CFjxxxx data formats, see the Windows API online 
Help. 

See also: TClipboardr.SetClipboardData, "GetCHpboardData 

GetClipboardFormatName inline int GetClipboardFormatName(UINT format, char far* formatName, 

int maxCount) const; 

Retrieves the name of the registered format specified by format and copies 
the format to the buffer pointed to by formatName. maxCount specifies the 
maximum length of the name of the format. If the name is longer than 
maxCount, it is truncated. 

See also: TClipboardr.CountClipboardFormats 
GetClipboardOwner inline HWND GetClipboardOwnerO const; 

Retrieves the handle of the window that currently owns the Clipboard. 

See also: •.-.GetClipboardOwner 
GetClipboardViewer inline HWND GetClipboardViewerO const; 

Retrieves the handle of the first window in the Clipboard-view chain. 

See also: TClipboard::SetClipboardViewer 

GetOpenClipboardWindOW HWND GetOpenClipboardWindowO const; 

Retrieves the handle of the window that currently has the Clipboard open. 
If the Clipboard is not open, the return value is FALSE. 

GetPriorityClipboardFormat inline int GetPriorityClipboardFormat(UINT FAR * priorityList, 

int count) const; 
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Returns the first Clipboard format in a list. priorityList points to an array 
that contains a list of the Clipboard formats arranged in order of priority. 
See the Windows API online Help for a description of these formats. 

IsClipboardFormatAvailable inline BOOL IsClipboardFormatAvailable(UINT format) const; 

Indicates if the format specified in format exists for use in the Clipboard. See 
the Windows API online Help for a description of Clipboard data formats. 



OpenClipboard 



operator BOOL 



QueryCreate 



QueryLink 



See also: r.IsClipboardFormat Available 

inline BOOL OpenClipboard (HWND Wnd); 

Opens the Clipboard and associates it with the window specified in Wnd. 

See also: TCIipboard: :CloseClipboard, '.-.OpenClipboard 

operator B00L() const; 

Checks handle. Should use IsOk instead. 



inline BOOL QueryCreate (const char far* protocol 

0LE0PT_RENDER renderopt = 
OLECLIPFORMAT format = 0' 



= DefaultProtocol, 
olerender_draw, 



QueryCreate determines if the object on the Clipboard supports the specified 
protocol and rendering options. DefaultProtocol points to a string specifying 
the name of the protocol the client needs to use. renderopt specifies the client 
application's display and printing preference for the Clipboard object. 
renderopt is set to olerender _draw , which specifies that the client application 
calls the Windows API function OleDraw, which tells the client library to 
obtain and manage the data presentation, format specifies the Clipboard 
format the client application requests. The macros _OLE_H or _INC_OLE 
must be defined before this function can be used. 

See the Windows API online Help for more information and a description 
of Clipboard formats. 

See also: TCIipboard: -.QueryLink 

inline BOOL QueryLink (const char far* protocol = DefaultProtocol, 
0LE0PT_RENDER renderopt = olerender_draw, 
OLECLIPFORMAT format = ) ; 

QueryLink determines if a client application can use the Clipboard data to 
produce a linked object that uses the specified protocol and rendering 
options. See TCIipboard: -.QueryCreate for a description of the parameters. 
The macros _OLE_H or _INC_OLE must be defined before this function 
can be used. 
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See the Windows API online Help for more information about this 
function. 

See also: TCIipboard: -.Query Create 

RegisterClipboardFormat inline UINT RegisterClipboardFormat (const char far* formatName) 
const; 

Registers a new Clipboard format. formatName points to a character string 
that identifies the new format. If the format can't be registered, the return 
value is 0. See the Windows API online Help for more information. 



SetClipboardData 



SetClipboardViewer 



See also: TClipboard-.-.CountClipboardFormats 

inline HANDLE SetClipboardData (UINT format, HANDLE handle); 

Sets a handle to the block of data at the location indicated by handle, format 
specifies the format of the data block. If successful, the return value is a 
handle to the data; if an error occurs, the return value is 0. See the Windows 
API online Help for more information. 

See also: TClipboardr.GetClipboardData, -.-.SetClipboardData 

inline HWND SetClipboardViewer (HWND Wnd) const; 

Adds the window specified by Wnd to the chain of windows that 
WM_DRAWCLIPBOARD notifies whenever the contents of the Clipboard 
change. 

See also: TClipboardr.GetClipboardViezver 



Protected data members 



IsOpen BOOL IsOpen; 

Returns TRUE if the Clipboard is open. 

TheClipboard static TCIipboard TheClipboard; 

Protected constructors and destructor 



Constructor 



Destructor 



TClipboardO; 

Constructs a TCIipboard object. 

-TClipboardO ; 

Destroys a TCIipboard object. 
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TCIipboardViewer class 



clipview.h 



Registers a TCIipboardViewer as a Clipboard viewer when the user interface 
element is created, and removes itself from the Clipboard-viewer chain 
when it is destroyed. 

Public constructors 

Constructor TCIipboardViewer (); 

Constructs a TClipboardView object. 

Constructor TCIipboardViewer (HWND hWnd, TModule* module = 0); 

Constructs a TCIipboardViewer object with a handle (hWnd) to the windows 
that will receive notification when the Clipboard's contents are changed. 

Public member functions 

EvChangeCBChain void EvChangeCBChain(HWND hWndRemoved, HWND hWndNext) ; 

Responds to a Windows API WM_CHANGECBCHAIN message. 
hWndRemoved is a handle to the window that's being removed. hWndNext is 
the window following the removed window. 



EvDestroy 



void EvDestroy () ; 

Responds to a Windows API WM_DESTROY message when a window is 
removed from the Clipboard-viewer chain. 

EvDrawClipboard void EvDrawClipboard ( ) ; 

Responds to a Windows API WM_DRAWCLIPBOARD message sent to the 
window in the Clipboard-viewer chain when the contents of the Clipboard 
change. 

SetupWindOW void SetupWindow ( ) ; 

Adds a window to the Clipboard-viewer chain. 

See also: TWindow:: SetupWindow 
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TCIipboardViewer class 



Protected data members 



HWndNext 



HWND HWndNext; 

Specifies the next window in the Clipboard-viewer chain. 



Response table entries 






Response table entry 


Member function 


EV_WM CHANGECBCHAIN 

EV_WM_DESTROY 

EV_WM_DRAWCLIPBOARD 


EvChangeCbChain 

EvDestroy 

EvDrawClipBoard 



TColor class 



color.h 



TColor is a support class used in conjunction with the classes TPalette, 
TPaletteEntry, TRgbQuad, and TRgbTriple to simplify all Windows color 
operations. TColor has ten static data members representing the standard 
RGB GOLORREF values, from Black to White. Constructors are provided to 
create TColor objects from COLORREF and RGB values, palette indexes, 
palette entries, and RGBQUAD and RGBTRIPLE values. See the entries for 
NBits and NColors for a description of TCo/or-related functions. 

Public data members 



Black 



Gray 



LtBlue 



LtCyan 



LtGray 



static const TColor Black; 

The static TColor object with fixed Value set by RGB(0, 0, 0). See the RGB 
Windows macro for more information. 

static const TColor Gray; 

Contains the static TColor object with fixed Value set by RGB(128, 128, 128). 

static const TColor LtBlue; 

Contains the static TColor object with the fixed Value set by RGB(0, 0, 255). 

static const TColor LtCyan; 

Contains the static TColor object with the fixed Value set by RGB(0, 255, 
255). 

static const TColor LtGray; 
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TColor class 



LtGreen 



LtMagenta 



LtRed 



LtYellow 



White 



Contains the static TColor object with the fixed Value set by RGB(192, 192, 
192). 

static const TColor LtGreen; 

Contains the static TColor object with the fixed Value set by RGB(0, 255, 0). 

static const TColor LtMagenta; 

Contains the static TColor object with the fixed Value set by RGB(255, 0, 

255). 

static const TColor LtRed; 

Contains the static TColor object with the fixed Value set by RGB(255, 0, 0). 

static const TColor LtYellow; 

Contains the static TColor object with the fixed Value set by RGB(255, 
255, 0). 

static const TColor White; 

Contains the static TColor object with the fixed Value set by RGB(255, 255, 
255). 

See also: Windows macro RGB 



Public constructors 



Constructor 



Constructor 



Constructor 



Constructor 



TColor ( ) ; 

The default constructor sets Value to 0. 

See also: TColor::Value 

TColor (C0L0RREF value); 

Creates a TColor object with Value set to the given value. 

See also: TColorr.Value 

TColor (long value) ; 

TColor(long value) : Value((COLORREF)value) {} 

Creates a TColor object with Value set to (COLORREF)value. 

See also: TColorr.Value, COLORREF 

TColor (int r, int g, int b) ; 

Creates a TColor object with Value set to RGB(r,g,b). 
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TColor class 



Constructor 



Constructor 



Constructor 



Constructor 



Constructor 



Blue 



Flags 



Green 



See also: TColor: -.Value, RGB macro 

TColor(int r, int g, int b, int f ) ; ' % 

Creates a TColor object with Value set to RGB(r,g,b) with the flag byte 
formed from /. 

See also: TColor::Value, PALETEENTRY struct 

TColor (int index) ; 

Creates a TColor object with Value set to PALETTEINDEX(index). 

See also: TColorr.Value, PALETTEINDEX macro 

TColor (const PALETTEENTRY far& pe) ; 
Creates a TColor object with Value set to: 

RGB(pe.peRed, pe.peGreen, pe.peBlue) 
See also: TColorr.Value, RGB macro, PALETEENTRY struct 
TColor (const RGBQUAD far& q); 
Creates a TColor object with Value set to: 

RGB(q.rgbRed, q.rgbGreen, g.rgbBlue) 
See also: TColorr.Value, RGB macro, RGBQUAD struct 
TColor (const RGBTRIPLE far& t); 
Creates a TColor object with Value set to: 

RGB(t.rgbtRed, t.rgbtGreen, t.rgbtBlue) 
See also: TColorrValue, RGB macro, RGBTRIPLE struct 

Public member functions 

inline BYTE Blue() const; 

Returns the blue component of this color's Value. 

See also: TColorr.Red, TColor r.Green, RGB 

inline BYTE Flags () const; 

Returns the peFlags value of this object's Value. 

See also: TPaletteEntry 

inline BYTE Green () const; 
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operator== 



operator 
COLORREFQ 



Index 



Pallndex 



PalRelative 



Red 



Rgb 



TColor class 

Returns the green component of this color's Value. 
See also: TColor::Red, TColorr.Blue, RGB 

inline BOOL operator— (const TColork clrVal) ; 

Returns TRUE if this color's Value equals clrValue; otherwise returns FALSE. 

See also: TColorr.Value 

inline operator C0L0RREF0 const; 

Type-conversion operator that returns Value. 

See also: TColorrValue 

inline int Index () const; 

Returns the index value corresponding to this color's Value by masking out 
the two upper bytes. Used when color is a palette index value. 

See also: TColor:: Value, COLORREF 

inline TColor Pallndex () const; 

Returns the palette index corresponding to this color's Value. The returned 
color has the high-order byte set to 1. 

See also: TColorr.Value, TColor: -.Index, COLORREF 

inline TColor PalRelative () const; 

Returns the palette-relative RGB corresponding to this color's Value. The 
returned color has the high-order byte set to 2. 

See also: TColor::Value, TColor::Rgb, COLORREF 

inline BYTE Red() const; 

Returns the red component of this color's Value. 

See also: TColorr.Blue, TColor r.Green, RGB 

inline TColor Rgb() const; 

Returns the explicit RGB color corresponding to this color's Value by 
masking out the high-order byte. 

See also: TColorr.Value, COLORREF 

Protected data members 



Value 



COLORREF Value; 
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TColor class 



The color value of this TColor object. Value can have three different forms, 
depending on the application: 

■ Explicit values for RGB (red, green, blue) 

■ An index into a logical color palette 

■ A palette-relative RGB value 



TComboBox class 



combobox.h 



You can use TComboBox to create a combo box or a combo box control in a 
parent TWindozv, or to facilitate communication between your application 
and the combo-box controls of TDialog. TComboBox objects inherit most of 
their behavior from TListBox. This class is streamable. 

There are three types of combo boxes: simple, drop down, and drop down 
list. These types are governed by the style constants CBS_SIMPLE, 
CBS_DROPDOWN, and CBS_DROPDOWNLIST. These constants, supplied 
to the constructor of a TComboBox, tell Windows the type of combo box 
element to create. 

Public data members 



TextLen 



WORD TextLen; 

Contains the length of the text in the combo box's associated edit control. 



Public constructors 



Constructor 



TComboBox (TWindow *parent, int Id, int x, int y, int w, int h, 
DWORD style, WORD textLen, TModule* module = 0); 

Constructs a combo box object with the specified parent window (parent), 
control ID (Id), position (x, y) relative to the origin of the parent window's 
client area, width (w), height (h), style (style), and text length (textLen). 

Invokes the TListBox constructor with similar parameters. Then sets 
Attr. Style as follows: 

Attr. Style. = WS_CHILD | WS_VISIBLE I WS_GR0UP I WS_TABSTOP I CBS_S0RT | 
CBS_AUTOHSCROLL | WS_VSCROLL I style; 

One of the following combo box style constants must be among the styles 
set in style: CBS_SIMPLE, CBS_DROPDOWN, CBS_DROPDOWNLIST, 
CBS_OWNERDRAWFIXED, or CBS_OWNERDRAWVARIABLE. 
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TComboBox class 



Constructor 



See also: TComboBox: -.TextLen, TListBox::TListBox 

TComboBox (TWindow* parent, int Id, WORD textLen, TModule* module = 0); 

Constructs a default combo box with the given parent window, control ID, 
and text length. 



Public member functions 



AddString 



Clear 



ClearList 



DeleteString 



DirectoryList 



FindString 



GetCount 



inline virtual int AddString (const char far* string); 

Adds a string to an associated list part of a combo box. Returns the index of 
the string in the list. The first entry is at index zero. Returns a negative 
value if an error occurs. 

inline void Clear () ; 

Clears the text of the associated edit control. 

inline virtual void ClearList (); 

Clears out all associated entries in the associated list. 

inline virtual int DeleteString (int index); 

Deletes the string at the passed index in the associated list part of a combo 
box. Returns a count of the entries remaining in the list or a negative value 
if an error occurs. 

inline virtual int DirectoryList (UINT attrs, const char far* fileSpec) ; 

Fills the combo box with file names from a specified directory. 

inline virtual int FindString (const char far* find, int indexStart) const; 

Searches for a match beginning at the passed Index. If a match is not found 
after the last string has been compared, the search continues from the 
beginning of the list until a match is found or until the list has been 
completely traversed. Returns the index of the first string in the associated 
list part of a combo box or a negative value if an error occurs. 



inline virtual int GetCount () const; 

Returns the number of entries in the associated list part of the combo box or 
a negative value if an error occurs. 

GetDroppedControlRect inline void GetDroppedControlRect(TRect& Rect) const; 

For combo boxes, gets the screen coordinates of the dropped down list box. 

GetDroppedState inline BOOL GetDroppedStateO const; 
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TComboBox class 



GetEditSel 



GetExtendedUl 



GetltemData 



GetltemHeight 



GetSellndex 



GetString 



GetStringLen 



For drop down combo boxes, determines if a list box is visible. 

int GetEditSel (int &startPos, int &endPos); 

Returns the starting and ending positions of the text selected in the 
associated edit control. Returns CB_ERR if the combo box has no edit 
control. 

inline BOOL GetExtendedUl ( ) const; 

Determines if the combo box has the extended user interface, which differs 
from the default user interface in the following ways: 

■ Displays the list box if the user clicks the static text field. 

■ Displays the list box if the user presses the i key. 

■ Disables scrolling in the static text field if the item list is not visible. 

Returns TRUE if the combo box has the extended user interface; otherwise 
returns FALSE. 

See also: TComboBox: -.SetExtendedUI 

inline virtual DWORD GetltemData (int index) const; 

Returns the 32-bit value associated with the combo box's item. 

See also: TListBox: -.GetltemData 

inline int GetltemHeight (int index) const; 

Returns the height in pixels of the Combo box's list items or CB_ERR if an 
error occurs. 

See also: TComboBoxr.GetltemData, TListBox: -.GetltemData 

inline virtual int GetSellndex () const; 

Returns the index of the list selection or a negative value if none exists. 

inline virtual int GetString (char far* str, int index) const; 

Retrieves the contents of the string at the position supplied in index and 
returns it in string. GetString returns the string length or a negative value if 
an error occurs. The buffer must be large enough for the string and the 
terminating zero. 

See also: TListBoxr.GetString 

inline virtual int GetStringLen (int index) const; 

Returns the string length (excluding the terminating zero) of the item at the 
position index supplied in index. Returns a negative value if an error 
occurs. 
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TComboBox class 



GetText 



GetTextLen 



HideList 



InsertString 



SetEditSel 



SetExtendedUl 



SetltemData 



SetltemHeight 



SetSellndex 



See also: TListBoxr.GetStringLen 

inline int GetText (char far* str, int maxChars) const; 

Retrieves the number of characters in the edit or static portion of the combo 
box. 

inline int GetTextLen () const; 

Returns the text length (excluding the terminating zero) of the edit control 
or static portion of the combo box. 

inline void HideList (); 

Hides the drop down list of a drop down or drop down list combo box. 

inline virtual int InsertString (const char far* str, int index); 

Inserts a string in the associated list part of a combo box at the position 
supplied in Index. Returns the index of the string in the list or a negative 
value if an error occurs. 

See also: TListBox: -.InsertString 

inline int SetEditSel (int startPos, int endPos); 

Selects characters that are between startPos and endPos in the 
edit control of the combo box. Returns CB_ERR if the combo box 
does not have an edit control. 

inline int SetExtendedUl (BOOL extended); 

If the combo box has the extended user interface, sets the extended user 
interface. 

See also: TComboBox: :GetExtendedUI 

inline virtual int SetltemData (int index, DWORD data); 

Sets the 32-bit value associated with the TComboBox's item. Returns 
CB_ERR if an error occurs. 

inline int SetltemHeight (int index, int height); 

Sets the height of the list items or the edit control portion in a combo box. If 
the index or height is invalid, returns CB_ERR. 

See also: TComboBox: :GetItemHeight 

inline virtual int SetSellndex (int index); 
Sets the index of the list selection. 
See also: TComboBox: :GetSelIndex 
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TComboBox class 



SetSelString inline virtual int SetSelString (const char far* findStr, int indexStart); 

Selects a string of characters in the associated list box and sets the contents 
of the associated edit control to the supplied string. 

SetText vo j_cl SetText (const char far* string); 

Selects the first string in the associated list box that begins with the 
supplied string. If there is no match, SetText sets the contents of the 
associated edit control to the supplied string and selects it. 

ShowList inline void ShowList (); 

Shows the list of a drop down or drop down list combo box. 

See also: TComboBox: :HideList 

ShowList void ShowList (BOOL show); 

Returns TRUE if the list is displayed. 

Transfer WORD Transfer (void* buffer, TTransferDirection direction); 

Transfers the items and selection of the combo box to or from a transfer 
buffer if tdSetData or tdGetData, respectively, is passed as the direction, 
buffer is expected to point to a TComboBoxData structure. 

Transfer returns the size of a pointer to a TComboBoxData. To retrieve the 
size without transferring data, your application must pass tdSizeData as 
the direction. 

b^ You must use a pointer in your transfer buffer to these structures. You 
cannot embed copies of the structures in your transfer buffer, and you 
cannot use these structures as transfer buffers. 

See also: TComboBoxData, TWindowr.Transfer 

Protected member functions 

GetClassName virtual char far* GetClassName ( ) ; 

Returns the name of TComboBox's Windows registration class, 
"ComboBox." 

SetupWindoW void SetupWindowO; 

Sets up the window and limits the amount of text the user can enter in the 
combo box's edit control to the value of TextLen minus 1. 

See also: T Window:: Setup Window 
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TComboBoxData class 



TComboBoxData class 



combobox.h 



A TComboBoxData is an interface object that represents a transfer buffer for 
a TComboBox. 



Public data members 



ItemDatas 



Selection 



Sellndex 



Strings 



TDwordArray* ItemDatas; 

Array of DWORDs to transfer into and out of the combo box's associated 
list box. 

See also: TComboBoxData: :SetItemData, TComboBoxData: :GetItemData 

char* Selection; 

Points to the currently selected string to transfer to or from a combo box. 

int Sellndex; 

Index of the selected item in the strings array. If zero, the index is used to 
transfer to. If negative, no item is selected. 

TStringArray* Strings; 

Array of class string to transfer in or out of the combo box's associated list 
box. 

Public constructors and destructor 



Constructor 



Destructor 



TComboBoxData ( ) ; 

Constructs a TComboBox object, initializes Strings and ItemDatas to empty 
arrays, and initializes Selection and Sellndex to 0. 

-TComboBoxData ( ) ; 

Deletes Strings, ItemDatas, and Selection. 



Public member functions 



AddltemData inline void AddltemData (DWORD itemData) ; 

Adds the user-defined item data to the ItemDatas array. 

AddString V oid AddString (const char *str, BOOL isSelected = FALSE); 
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TComboBoxData class 



Adds the specified string to the array of Strings. If IsSelected is TRUE, 
AddString deletes Selection and copies string into Selection. 

AddStringltem inline void AddStringltem (const char* str, DWORD itemData, 

BOOL isSelected = FALSE) ; 

Calls AddltemData to add the item data to the ItemDatas array, and calls 
AddString to add a string to the array of Strings. 



TCommonDialog class 



commdial.h 



Derived from TDialog, TCommonDialog is the abstract base class for 
TCommonDialog objects. It provides the basic functionality for creating 
dialog boxes using the common dialog DLL. 

Public constructors 



Constructor 



TCommonDialog (TWindow* parent, const char far* title = 0, TModule* 
module = 0) ; 

Invokes a TWindow constructor, passing parent and library ID. Constructs a 
common dialog box. 



Public member functions 



DoCreate 



DoExecute 



HWND DoCreate ( ) ; 

Called by Create, DoCreate creates a modeless dialog box. It returns if 
unsuccessful. 

See also: TDialog: -.Create 

int DoExecute () ; 

Called by Execute, DoExecute creates a modal dialog box. It returns 
IDCANCEL if canceled or unsuccessful. 

See also: TDialog: -.Execute 

Protected data members 



CDTitle 



const char far* CDTitle; 

CDTitle stores the optional caption displayed in the common dialog box. 
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TCommon Dialog class 



See also: TDialogr.SetCaption 



Protected member functions 



CmHelp inline void CmHelpO; 

Default handler for the pshHelp push button (the Help button in the dialog 
box). 

CmOkCancel inline void CmOkCancel () ; 

Responds to a click on the dialog box's OK or Cancel button by calling 
DefaultProcessing to let the common dialog DLL process the command. 

See also: TDialog::Cancel, TDialog::Ok 

EvClose inline void EvClose (); 

Responds to a WM_CLOSE message by calling DefaultProcessing to let the 
common dialog DLL process the command. 

See also: TDialog::EvClose 

SetupWindow void SetupwindowO; 

Assigns the caption of the dialog box to CDTitle if CDTitle is nonzero. 

See also: TDialogr.SetupWindow 



Response table entries 






Response table entry 


Member function 


EV_COMMAND(IDCANCEL, CmOkCancel) 
EV_COMMAND(IDOK, CmOkCancel) 
EV_WM_CLOSE 
EV_WM_CTLCOLOR 


CmOkCancel 
CmOkCancel 
EvClose 
EvCtlColor 



TCondFunc type 



window.h 



Defines a member function type used by TWindow's function FirstThat. 

typedef BOOL (*TCondFunc) (TWindow *win, void *param) ; 
See also: TWindow ::FirstThat 
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TCondMemFunc typedef 



TCondMemFunc typedef 



window.h 



Defines a member function type used by TWindow's function FirstThat. 

typedef BOOL (TWindow: : TCondMemFunc) (*win, void *param) ; 
See also: TWindow: -.FirstThat 



TControl class 



control.h 



TControl unifies its derived control classes, such as TScrollBar, 
TControlGadget, and TButton. Control objects of derived classes are used to 
represent control interface elements in Windows. A control object must be 
used to create a control in a parent TWindow or a derived window. A 
control object can be used to facilitate communication between your 
application and the controls of a TDialog. TControl is a streamable class. 

Public constructors 

Constructor TControl (TWindow *parent, int Id, const char far *title, int x, int y, 

int w, int h, TModule* module = 0) ; 

Invokes TWindow's constructor, passing it parent (parent window), title 
(caption text), and module. Sets Attr using the supplied library ID (Id), 
position (x, y) relative to the origin of the parent window's client area, 
width (w), and height (h) parameters. It sets Attr. Style to WS_CHILD I 
WS_VISIBLE I WS_GROUP I WS_TABSTOP. 

See also: TWindow: :TWindow 

Constructor TControl (TWindow *parent, int resourceld, TModule* module = 0); 

Constructs an object to be associated with an interface control of a TDialog. 
Invokes the TWindow constructor, and then enables the data transfer 
mechanism by calling EnableTransfer. 

The Resld parameter must correspond to a control interface resource that 
you define. 

See also: TWindow ::T Window, TWindow: -.EnableTransfer 

Public member functions 



Compareltem 



virtual int Compareltem (COMPAREITEMSTRUCT far &) 
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TControl class 



Deleteltem 



Drawltem 



Measureltem 



Used in owner-draw combo boxes, Compareltem compares two items. The 
derived class supplies the compare logic. 

virtual void Deleteltem (DELETEITEMSTRUCT far &) ; 

Deleteltem is used in owner-draw combo boxes. In such cases, the derived 
class supplies the delete logic. 

virtual void Drawltem (DRAWITEMSTRUCT far kdrawlnfo) ; 

Drawltem responds to a message forwarded to a drawable control by 
TWindow when the control needs to be drawn. TControl: -.Drawltem calls 
ODADrawEntire if the entire control needs to be drawn, calls ODASelect if 
the selection state of the control has changed, or calls OD AFocus if the focus 
has been shifted to or from the control. 

See also: TControl::ODADrawEntire, TControl: -.ODASelect, 
TControl::ODAFocus, TWindow::EvDrawItem 

virtual void Measureltem (MEASURE I TEMSTRUCT far &) ; 

Used by owner-drawn controls to inform Windows of the dimensions of 
the specified item. For list boxes and control boxes, this function applies to 
specific items; for other owner-drawn controls, this function is used to 
inform Windows of the total size of the control. 



EvPaint 



ODADrawEntire 



ODAFocus 



Protected member functions 

void EvPaint ( ) ; 

If the control has a predefined Windows class, EvPaint calls 

TWindow: :DefaultProcesing for Windows-supplied painting. Otherwise, it 

calls TWindow: -.EvPaint. 

See also: TWindow r.DefaultProcesing, TWindow: -.EvPaint 

virtual void ODADrawEntire (DRAWITEMSTRUCT far &drawInfo); 

Responds to a notification message sent to a drawable control when the 
control needs to be drawn. ODADrawEntire can be redefined by a drawable 
control to specify the manner in which it is to be drawn. 

See also: TWindowr.EvDrawItem, TControl: -.Drawltem 

virtual void ODAFocus (DRAWITEMSTRUCT far kdrawlnfo) ; 

Responds to a notification sent to a drawable control when the focus has 
shifted to or from the control. ODAFocus can be redefined by a drawable 
control to specify the manner in which it is to be drawn when losing or 
gaining the focus. 
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I Uontrol class 



See also: TWindow::EvDrawItem, TControlr.Drawltem 

ODASelect virtual void ODASelect (DRAWITEMSTRUCT far &drawInfo) ; 

Responds to a notification sent to a drawable control when the selection 
state of the control changes. By default, ODASelect calls Parent->DrawItem. 
ODASelect can be redefined by a drawable control to specify the manner in 
which it is drawn when its selection state changes. 

See also: TWindow::EvDrawItem, Drawltem 



Response table entries 






Response table entry 


Member function 


EV_WM_PAINT 


EvPaint 



TControlBar class controlb.h 

Derived from T Gadget Window, TControlBar implements a control bar that 
provides mnemonic access for its button gadgets. To construct, build, and 
insert a control bar into a frame window, you can first define the following 
response table: 

DEFINE_RESPONSE_TABLEl(TMDIFileApp, TApplication) 

EV_COMMAND(CM_FILENEW, CmFileNew) , 

EV_COMMAND(CM_FILEOPEN, CmFileOpen) , 

EV_COMMAND(CM_SAVESTATE, CmSaveState) , 

EV_COMMAND(CM_RESTORESTATE, CmRestoreState) , 
END_RESPONSE_TABLE; 

Next, add statements that will construct a main window and load its menu, 
accelerator table, and icon. Then, to construct, build and insert a control bar 
into the frame window, insert these statements: 

TControlBar* cb = new TControlBar ( frame) ; 

cb->Insert ( *new TButtonGadget (CM_FILENEW, CM_FILENEW) ) ; 

cb->Insert (*new TButtonGadget (CM_FILEOPEN, CM_FILEOPEN) ) ; 

cb->Insert(*new TButtonGadget (CM_FILESAVE, CM_FILESAVE) ) ; 

cb->Insert (*new TSeparatorGadget (6) ) ; 

cb->Insert (*new TButtonGadget (CM_EDITCUT, CM_EDITCUT) ) ; 

cb->Insert (*new TButtonGadget (CM_EDITCOPY, CM_EDITCOPY) ) ; 

cb->Insert (*new TButtonGadget (CM_EDITPASTE, CM_EDITPASTE) ) ; 

cb->Insert ( *new TSeparatorGadget ( 6 ) ) ; 

cb->Insert(*new TButtonGadget (CM_EDITUNDO, CM_EDITUNDO) ) ; 

frame->.Insert(*cb, TDecoratedFrame: -.Top) ; 
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TControlBar class 



The sample MDIFILE.CPP ObjectWindows program on your distribution 
disk displays the following control bar: 



MDI File Editor 



File Window 



Dlc^j 



IL-JBJG 



Button gadgets 



Control bar 



Public constructors 



Constructor TControlBar (TWindow* parent = 0, TTileDirection direction = Horizontal, 

TFont* font = new TGadgetWindowFont , TModule* module = 0); 

Constructs a TControlBar interface object with the specified direction (either 
horizontal or vertical) and window font. 



Public member functions 



PreProcessMsg B 0OL PreProcessMsg (MSG& msg); 

Performs preprocessing of Windows messages. Because PreProcessMsg does 
not translate any accelerator keys for TControlBar, it returns FALSE. 



Protected member functions 



PositionGadget vo id PositionGadget(TGadget* previous, TGadget* next, TPointk p) ; 

Gets the border style, determines the direction of the gadget, and positions 
the button gadget on either a horizontal or vertical border if any 
overlapping is required. 



TControlGadget class 



controlg.h 



TControlGadget serves as a surrogate for TControl so that you can place 
TControl objects such as edit controls, buttons, sliders, gauges, or VBX 
controls, into a gadget window. If necessary, TControlGadget sets a parent 
window and creates the control gadget. See TGadget for more information 
about gadget objects. 
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Public constructors and destructor 



Constructor TControlGadget (TWindow&. control, TBorderStyle = None); 

Creates a TControlGadget object associated with the specified TControl 
window. 

Destructor -TControlGadget () ; 

Destroys a TControlGadget object and removes it from the associated 
window. 



Protected data members 



Control 



TWindow* Control; 

Points to the control window that is managed by this TControlGadget. 



Protected member functions 



GetDesiredSize void GetDesiredSize(TSize& size) ; 

Calls TGadgetr.GetDesiredSize and passes the size of the control gadget. 

See also: TGadgetr.GetDesiredSize 
GetlnnerRect vo id GetInnerRect(TRect&) ; 

Computes the area of the control gadget's rectangle excluding the borders 
and margins. 

Inserted vo id msertedO; 

Called when the control gadget is inserted in the parent window. Calls 
::ShozvWindow to display the window in its current size and position. 

Invalidate void Invalidate (BOOL erase = TRUE); 

Used to invalidate the active (usually nonborder) portion of the control 
gadget, Invalidate calls InvalidateRect and passes the boundary width and 
height of the area to erase. 

InvalidateRect vo id InvalidateRect (const TRect&, BOOL erase = TRUE); 

Invalidates the control gadget rectangle in the parent window. 
Removed ■ void Removed () ; 

Called when the control gadget is removed from the parent window. 
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SetBounds 



Update 



void SetBounds (TRect& rect) ; 

Calls TGadget::SetBounds and passes the dimensions of the control gadget's 
rectangle. SetBounds informs the control gadget of a change in its bounding 
rectangle. 

See also: TGadget::SetBounds 

void Update!) ; 

Calls the Windows API function r.UpdateWindow to update the client area of 
the specified window by sending a WM_PAINT message immediately. 

Response table entries 

The TControlGadget class has no response table entries. 



TCreatedDC class 



dc.h 



An abstract TDC class, TCreatedDC serves as the base for DCs that are 
created and deleted. TCreatedDC does much of the work of creating and 
deleting HDCs using CreateDC and r.DeleteDC. See TDC for more 
information about DC objects. 

Public constructors and destructor 

Constructor TCreatedDC (const char far* driver, const char far* device, 

const char far* output, const DEVMODE far* initData=0); 

Creates a DC object for the device specified by driver (driver name), device 
(device name), and out-put (the name of the DOS file or device [port] for the 
physical output medium). The optional initData argument provides a 
DEVMODE structure containing device-specific initialization data for this 
DC. initData must be (the default) if the device is to use any default 
initializations specified by the user via the Control Panel. 

See also: r.CreateDC, ::ExtDeviceMode 
Constructor TCreatedDC (HDC handle, TAutoDelete autoDelete) ; 

Creates a DC object using an existing DC. 

See also: enum TDCr.TAutoDelete, TDCr.ShouldDelete 
Destructor -TCreatedDC ( ) ; 
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Calls RestoreObjects and clears any nonzero OrgXXX data members. If 
ShouldDelete is TRUE, the destructor deletes this DC via r.DeleteDC. 

See also: TDC::ShouldDelete, r.DeleteDC, TDC::RestoreObjects 



Protected member functions 



TCreatedDC 



TCreatedDC (); 

Creates a device context for the given device. DC objects can be constructed 
either by borrowing an existing HDC handle or by supplying device and 
driver information. 

See also: ::CreateDC 



TCursor class 



gdiobjec.h 



TCursor, derived from TGdiobject, represents the GDI cursor object class. 
TCursor constructors can create cursors from a resource or from explicit 
information. Because cursors are not real GDI objects, the TCursor 
destructor overloads the base destructor, ~TGdiOject(). 

Public constructors and destructor 



Constructor 



Constructor 



Constructor 



TCursor (HCURSOR handle, TAutoDelete autoDelete = NoAutoDelete).; 

Creates a TCursor object and sets the Handle data member to the given 
borrowed handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle will not be deleted when the C++ object 
is destroyed. 

See also: TGdiObjectr.Handle, TGdiObjectr.ShouldDelete 

TCursor (HINSTANCE instance, const TCursor& cursor); 

Creates a copy of the given cursor object by calling the Win API function 

Copy Cur sordnstance, cursor). 

See also: ::CopyIcon, ::CopyCursor 
TCursor (HINSTANCE instance, TResID resID) ; 
Constructs a cursor object from the specified resource ID. 
See also: ::LoadCursor 
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Constructor 




Constructor 



Constructor 




Destructor 



TCursor (HINSTANCE instance, const TPoint& hotSpot, const TSizek size, 
void far* andBits, void far* xorBits) ; 

Constructs a TCursor object of the specified size and at the specified point. 

See also: r.CreateCursor, TPoint, TSize 

TCursor(const void* resBits, DWORD resSize) ; 
Constructs a TCursor object from the specified resource. 
See also: r.CreatelconFromResource 

TCursor (const ICONINFO* iconlnfo); 

Creates a TCursor object from the specified ICONINFO structure 
information. 

See also: r.Createlconlndirect 

virtual -TCursor ( ) ; 

Destroys a TCursor object. 

See also: ~TGdiObject 



Public member functions 



operator 
HCURSOR() 



Getlconlnfo 




operator HCURSORO const; 

An inline typecasting operator. Converts this cursor's Handle to type 
HCURSOR (the Windows data type representing the handle to a cursor 
resource). 

inline BOOL Getlconlnfo (ICONINFO* iconlnfo) const; 

Retrieves information about this icon and copies it in the given ICONINFO 
structure. Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: : -.Getlconlnfo, struct ICONINFO 



TDC class 



dc.h 



TDC is the root class for GDI DC wrappers. Each TDC object has a Handle 
protected data member of type HDC (handle to DC). Win API functions 
that take an HDC argument can therefore be called by a corresponding 
TDC member function without this explicit handle argument. 
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DC objects can be created directly with TDC constructors, or via the 
constructors of specialized subclasses (such as TWindowDC, TMemoryDC, 
TMetaFileDC, TDibDC, and TPrintDC) to get specific behavior. DC objects 
can be constructed with an already existing and borrowed HDC handle or 
from scratch by supplying device /driver information as with ::CreateDC(). 
The class TCreateDC takes over much of the creation and deletion work 
from TDC. 

TDC has four handles as protected data members: OrgBrush, OrgPen, 
OrgFont, and Or gP alette. These handles keep track of the stock GDI objects 
selected into each DC. As new GDI objects are selected with SelectObjectO or 
SelectPaletteO, these data members store the previous objects. The latter can 
be restored individually with RestoreBrush, RestoreP en() , and so on, or they 
can all be restored with RestoreObjectsO. When a TDC object is destroyed 
(via ~TDC::TDC), all the originally selected objects are restored. The data 
member TDCr.ShouldDelete controls the deletion of the underlying 
Windows DC. 

Public data members 



enum 
TAutoDelete 



enum TAutoDelete {NoAutoDelete, AutoDelete}; 

Flag for handle constructors to control GDI object deletion in the TDC 
destructor. 

See also: TDCr.ShouldDelete, -TDC 



Public constructors and destructor 

Constructor TDC(HDC handle, TAutoDelete autoDelete = NoAutoDelete); 

Creates a DC object "borrowing" the handle of an existing DC. The Handle 
data member is set to the given handle argument. 

See also: enum TDCr.T AutoDelete, TDCr.ShouldDelete 

Constructor TDC (const char far* driver, const char far* device, 

const char far* output, const DEVMODE far* initData = 0); 

Creates a DC object for the device specified by driver (driver name), device 
(device name), and output (the name of the DOS file or device [port] for the 
physical output medium). The optional initData argument provides a 
DEVMODE structure containing device-specific initialization data for this 
DC. initData must be (the default) if the device is to use any default 
initializations specified by the user via the Control Panel. 
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Destructor 



See also: ::CreateDC, ::ExtDeviceMode, TCreatedDC 

virtual ~TDC ( ) ; 

Calls RestoreObjects and clears any nonzero OrgXXX data members. If 
ShouldDelete is TRUE, the destructor deletes this DC via ::DeleteDC. 

See also: TDCr.ShouldDelete, r.DeleteDC, TDC::RestoreObjects 



Public member functions 



AngleArc 




Arc 



BeginPath 




inline BOOL AngleArc (int x, int y, DWORD radius, float startAngle, 

float sweepAngle) ; 
inline BOOL AngleArc (const TPointk center, DWORD radius, float startAngle, 

float sweepAngle) ; 

Draws a line segment and an arc on this DC using the currently selected 
pen object. The line is drawn from the current position to the beginning of 
the arc. The arc is that part of the circle (with the center at logical 
coordinates (x, y) and positive radius, radius) starting at startAngle and 
ending at {startAngle + sweepAngle). Both angles are measured in degrees, 
counterclockwise (the default arc direction) from the x-axis. The arc might 
appear to be elliptical, depending on the current transformation and 
mapping mode. AngleArc returns TRUE if the figure is drawn successfully; 
otherwise, it returns FALSE. If successful, the current position is moved to 
the end point of the arc. 

See also: r.AngleArc, TDCr.Arc, ::SetArcDirection 

inline BOOL Arc(int xl, int yl, int x2, int y2, int x3, int y3, int x4, 

int y4); 
inline BOOL Arc(const TRectk r, const TPointk start, const TPoint& end); 

Draws an elliptical arc on this DC using the currently selected pen object. 
The center of the arc is the center of the bounding rectangle, specified either 
by (xl, yl)/(x2, yl) or by the rectangle r. The starting /ending points of the 
arc are specified either by (x3, y3)/(x4, y4) or by the points start and end. All 
points are specified in logical coordinates. Arc returns TRUE if the arc is 
drawn successfully; otherwise, it returns FALSE. The current position is 
neither used nor altered by this call. The drawing direction is set by 
r.SetArcDirection; the default is counterclockwise. 

See also: ::Arc, r.SetArcDirection, TDCr.AngleArc 

inline BOOL BeginPath (); 

Opens a new path bracket for this DC and discards any previous paths 
from this DC. Once a path bracket is open, an application can start calling 
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draw functions on this DC to define the points that lie within that path. The 
draw functions that define points in a path are the following TDC 
members: AngleArc, Arc, Chord, CloseFigure, Ellipse, ExtTextOut, LineTo, 
MoveToEx, Pie, PolyBezier, PolyBezierTo, PolyDraw, Polygon, Polyline, 
PolylineTo, PolyPolygon, PolyPolyline, Rectangle, RoundRect, and TextOut. 

A path bracket can be closed by calling TDC::EndPath. 

BeginPath returns TRUE if the call is successful; otherwise, it returns 
FALSE. 

See also: ::BeginPath, TDC::FillPath, TDCr.EndPath, 
TDC::PathToRegion, TDC::StrokePath, TDC::StrokeandFillPath, 
TDC::WidenPath 

BitB,t inline BOOL BitBlt(int dstX, int dstY, int w, int h, const TDC& srcDC, 

int srcX, int srcY, DWORD rop) ; 
inline BOOL BitBlt (const TRect& dst, const TDC& srcDC, const TPoint& src, 
DWORD rop) ; 

Performs a bit-block transfer from srcDc (the given source DC) to this DC 
(the destination DC). Color bits are copied from a source rectangle to a 
destination rectangle. The location of the source rectangle is specified either 
by its upper left-corner logical coordinates (srcX, srcY), or by the TPoint 
object, src. The destination rectangle can be specified either by its upper 
left-corner logical coordinates (dstX, dstY), width w, and height h, or by the 
TRect object, dst. The destination rectangle has the same width and height 
as the source. The rop argument specifies the raster operation used to 
combine the color data for each pixel. See TDC::MaskBlt for a detailed list of 
rop codes. 

When recording an enhanced metafile, an error occurs if the source DC 
identifies the enhanced metafile DC. 

If necessary, PlgBlt adjusts the source color formats to match those of the 
destination. Before using PlgBlt, an application should call GetDeviceCaps to 
determine if the source and destination DCs are compatible. If they are 
incompatible, an error occurs. 



Chord 



See also: ::BitBlt 

inline BOOL Chord (int xl, int yl, int x2, int y2, int x3, int y3, int x4, 

int y4 ) ; 
inline BOOL Chord (const TRect& R, const TPoint& Start, const TPoint& End); 

Draws and fills a chord (a region bounded by the intersection of an ellipse 
and a line segment) on this DC using the currently selected pen and brush 
objects. The ellipse is specified by a bounding rectangle given either by (xl, 
yl)/(x2, yl) or by the rectangle R. The starting/ending points of the chord 



94 ObjectWindows 2.0 Reference Guide 



TDC class 



CloseFigure 




DPtoLP 



DrawFocusRect 



Drawlcon 



are specified either by (x3, y3)/(x4, y4) or by the points Start and End. Chord 
returns TRUE if the call is successful; otherwise, it returns FALSE. The 
current position is neither used nor altered by this call. 

See also: nChord, TDC:: Arc 

inline BOOL CloseFigure () ; 

Closes an open figure in this DCs open path bracket by drawing a line from 
the current position to the first point of the figure (usually the point 
specified by the most recent TDCr.MoveTo call), and connecting the lines 
using the current join style for this DC. If you close a figure with 
TDC::LineTo instead of with CloseFigure, end caps (instead of a join) are 
used to create the corner. The call fails if there is no open path bracket on 
this DC. Any line or curve added to the path after a CloseFigure call starts a 
new figure. A figure in a path remains open until it is explicitly closed with 
CloseFigure even if its current position and start point happen to coincide. 

CloseFigure returns TRUE if the call is successful; otherwise, it returns 
FALSE. 

See also: r.CloseFigure, TDC::BeginPath,TDC::EndPath 

inline BOOL DPtoLP (TPoint* points, int count = 1) const; 

Converts each of the count points in the ipoints array from device points to 
logical points. The conversion depends on this DCs current mapping mode 
and the settings of its window and viewport origins and extents. DPtoLP 
returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: TDC::LPtoDP, r.DPtoLP 

inline BOOL DrawFocusRect (int xl, int x2, int yl, int y2); 
inline BOOL DrawFocusRect (const TRect& rect); 

Draws the given rectangle on this DC in the style used to indicate focus. 
Calling the function a second time with the same rect argument will 
remove the rectangle from the display. A rectangle drawn with 
DrawFocusRect cannot be scolled. DrawFocusRect returns TRUE if the call is 
successful; otherwise, it returns FALSE. 

See also: : .-DrawFocusRect 

inline BOOL DrawIcon(int x, int y, const TIcon& icon); 
inline BOOL Drawlcon (const TPointk point, const TIcon& icon); 

Draws the given icon on this DC. The upper left corner of the drawn icon 
can be specified by x- and y-coordinates or by the point argument. Drawlcon 
returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: r.DrawIcon 
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DrawText 



inline virtual BOOL DrawText (const char far* string, int count, 

const TRect& r, WORD format = 0); 

Formats and draws in the given rectangle, r, up to count characters of the 
null-terminated string using the current font for this DC. If count is -1, the 
whole string is written. The rectangle must be specified in logical units. 
Formatting is controlled with the format argument, which can be various 
combinations of the following values: 



Value 



Meaning 



DT_BOTTOM 
DT CALCRECT 



DT_CENTER 
DT_EXPANDTABS 

DT_EXTERNALLEADING 

DT_LEFT 
DT_NOCLIP 

DT NOPREFIX 



DT_RIGHT 
DT_SINGLELINE 

DTJABSTOP 

DT_TOP 

DT VCENTER 



Specifies bottom-justified text. This value must be combined (bitwise 
OR'd) with DT_SINGLELINE. 

Determines the width and height of the rectangle. If there are multiple 
lines of text, DrawText uses the width of /-(the rectangle argument) 
and extends the base of the rectangle to bound the last line of text. If 
there is only one line of text, DrawText uses a modified value for the 
right side of rso that it bounds the last character in the line. In both 
cases, DrawText returns the height of the formatted text but does not 
draw the text. 

Centers text horizontally. 

Expands tab characters. The default number of characters per tab is 
eight. 

Includes the font external leading in line height. Normally, external 
leading is not included in the height of a line of text. 

Aligns text flush-left. 

Draws without clipping. DrawText \s somewhat faster when 
DT_NOCLIP is used. 

Turns off processing of prefix characters. Normally, DrawText 
interprets the prefix character & as a directive to underscore the 
character that follows, and the prefix characters && as a directive to 
print a single &. By specifying DT_NOPREFIX, this processing is 
turned off. 

Aligns text flush-right. 

Specifies single line only. Carriage returns and linefeeds do not break 
the line. 

Sets tab stops. Bits 15-8 (the high-order byte of the low-order word) 
of the format argument are the number of characters for each tab. 
The default number of characters per tab is eight. 

Specifies top-justified text (single line only). 

Specifies vertically centered text (single line only). 
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DT_WORDBREAK Specifies word breaking. Lines are automatically broken between 

words if a word would extend past the edge of the rectangle specified 
by r. A carriage return/line sequence will also break the line. 

Note that the DT_CALCRECT, DT_EXTERNALLEADING, 
DTJNTERNAL, DT_NOCLIP, and DT_NOPREFIX values cannot be used 
with the DTJTABSTOP value. 

DrawText uses this DCs currently selected font, text color, and background 
color to draw the text. Unless the DT_NOCLIP format is used, DrawText 
clips the text so that it does not appear outside the given rectangle. All 
formatting is assumed to have multiple lines unless the DT_SINGLELINE 
format is given. 

If the selected font is too large for the specified rectangle, DrawText does 
not attempt to substitute a smaller font. 

If successful, DrawText returns the height of the text; otherwise, it returns 0. 

See also: r.DrawText, TDC r.Gray String, TDCr.TabbedTextOut, TDC::TextOut 

Ellipse inline BOOL Ellipse (int xl, int yl, int x2, int.y2); 

inline BOOL Ellipse(const TPoint& pi, const TPoint& p2); 

inline BOOL Ellipse (const TPoint& point, const TSize& size); 

inline BOOL Ellipse(const TRectk rect); 

Draws and fills an ellipse on this DC using the currently selected pen and 
brush objects. The center of the ellipse is the center of the bounding 
rectangle specified either by (xl, yl)/(x2, yl) or by the rect argument. Ellipse 
returns TRUE if the call is successful; otherwise, it returns FALSE. The 
current position is neither used nor altered by this call. 

See also: : -.Ellipse, TDCr.Arc 

EndPath inline BOOL EndPathO ; 

Closes the path bracket and selects the path it defines into this DC. 
Returns TRUE if the call is successful; otherwise, returns FALSE. 

See also: r.EndPath, TDCr.BeginPath, TDCr.CloseFigure 

EnumFontFamilies inline int EnumFontFamilies (const char far* family, F0NTENUMPROC proc, 

void* data) const; 

Enumerates the fonts available to this DC in the font family specified by 
family. The given application-defined callback proc (created with 
r.MakeProcInstance) is called for each font in the family or until proc returns 
0. data lets you pass both application-specific data and font data to proc. If 
successful, the call returns the last value returned by proc. 

See also: ::EnumFontFamilies, ::EnumFontFamProc 
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EnumFontS inline int EnumFonts (const char far* faceName, OLDFONTENUMPROC callback, 

void* data) const; 

Enumerates the fonts available on this DC for the given faceName. The font 
type, LOGFONT, and TEXTMETRIC data retrieved for each available font 
is passed to the user-defined callback function together with any optional, 
user-supplied data placed in the data buffer. The callback function can 
process this data in any way desired. Enumeration continues until there are 
no more fonts or until callback returns 0. If faceName is 0, EnumFonts 
randomly selects and enumerates one font of each available typeface. 
EnumFonts returns the last value returned by callbackO. Note that 
OLDFONTENUMPROC is defined as FONTENUMPROC for Win32 only. 
FONTENUMPROC is a pointer to a user-defined function; it has the 
following prototype: 

int CALLBACK EnumFonts Proc (LOGFONT *lplf, TEXTMETRIC *lptm, DWORD dwType, LPARAM 

lpData) ; 

where dwType specifies the font type: DEVICE_FONTTYPE, 
RASTER_FONTTYPE, or TRUETYPE_FONTTYPE. 

See also: r.EnumFonts, r.EnumFontsProc, TDCr.EnumFontF amities 

EnumMetaFile inline int EnumMetaFile (const TMetaFilePict& metaFile, 

MFENUMPROC callback, void* data) const; 

Enumerates the GDI calls within the given metaFile. Each such call is 
retrieved and passed to the given callback function, together with any client 
data from data, until all calls have been processed or a callback function 
returns 0. 

See also: •.■.EnumMetaFile, TDCr.PlayMetaFile 

EnumObjectS i nt EnumObjectsO const; 

Enumerates the pen or brush objects available for this DC. 

ExcludeCNpRect inline int ExcludeClipRect (const TRect& rect); 

Creates a new clipping region for this DC. This new region consists of the 
current clipping region minus the given rectangle, rect. The return value 
indicates the new clipping region's type as follows: 



Region 



Meaning 



COMPLEXREGION Clipping Region has overlapping borders. 

ERROR Invalid DC. 

NULLREGION Clipping region is empty. 

SIMPLEREGION Clipping region has no overlapping borders. 
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See also: r.ExcludeClipRect, TDCr.GetClipBox 

ExcludeUpdateRgn inline int Exclude(JpdateRgn(HWND wnd); 

Prevents drawing within invalid areas of a window by excluding an 
updated region of this DCs window from its clipping region. The return 
value indicates the resulting clipping region's type as follows: 



Region 



Meaning 



ExtFloodFill 



COMPLEXREGION Clipping Region has overlapping borders. 

ERROR Invalid DC. 

NULLREGION Clipping region is empty. 

SIMPLEREGION Clipping region has no overlapping borders. 

See also: TDC::IntersectClipRect, r.ExcludellpdateRgn, TDCr.GetClipBox 

inline BOOL ExtFloodFill (const TPoint& point, TColor color, 

WORD fillType); 

Fills an area on this DC starting at point and using the currently selected 
brush object. The color argument specifies the color of the boundary or of 
the region to be filled. The fillType argument specifies the type of fill, as 
follows: 



ExtTextOut 



FLOODFILLBORDER The fill region is bounded by the given color. This style coincides with 

the filling method used by FloodFillQ. 

FLOODFILLSURFACE The fill region is defined by the given color. Filling continues outward 
in all directions as long as this color is encountered. Use this style 
when filling regions with multicolored borders. 

Not every device supports ExtFloodFill, so applications should test first with 
TDCr.GetDeviceCaps. 

ExtFloodFill returns TRUE if the call is successful; otherwise, it returns 
FALSE. 

See also: TDCr.FloodFill, ::ExtFloodFill, TDCr.GetDeviceCaps 

inline virtual BOOL ExtTextOut (int x, int y, WORD options, const TRect* r, 

const char far* string, int count, 
const int* dx = 0) ; 
inline BOOL ExtTextOut (const TPoint& p, WORD options, const TRect* r, 
const char far* string, int count, 
const int* dx = 0) ; 

Draws up to count characters of the given null-terminated string in the 
current font on this DC. If count is -1, the whole string is written. 
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FillPath 




FiilRect 



FillRgn 



An optional rectangle r can be specified for clipping, opaquing, or both, as 
determined by the options value. If options is set to ETO_CLIPPED, the 
rectangle is used for clipping the drawn text. If options is set to 
ETO_OPAQUE, the current background color is used to fill the rectangle. 
Both options can be used if ETO_CLIPPED is OR'd with ETO_OPAQUE. 

The (x, y) or p arguments specify the logical coordinates of the reference 
point that is used to align the first character. The current text-alignment 
mode can be inspected with TDCr.GetText Align and changed with 
TDC: -.SetText Align. By default, the current position is neither used nor 
altered by ExtTextOut. However, if the align mode is set to 
TAJJPDATECP, ExtTextOut ignores the reference point argument(s) and 
uses or updates the current position as the reference point. 

The dx argument is an optional array of values used to set the distances 
between the origins (upper left corners) of adjacent character cells. For 
example, dx[i] represents the number of logical units separating the origins 
of character cells i and z'+l. If dx is 0, ExtTextOut uses the default inter- 
character spacings. 

ExtTextOut returns TRUE if the call is successful; otherwise, it returns 
FALSE. 

See also: TDCr.TextOut, TDCv.GetText Align, TDC::TabbedTextOut, 
-.-.ExtTextOut 

inline BOOL FillPathf); 

Closes any open figures in the current path of this DC and fills the path's 
interior using the current brush and polygon fill mode. After filling the 
interior, FillPath discards the path from this DC. 

FillPath returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: •.-.FillPath, TDC::BeginPath, TDCr.CloseFigure, TDC::StrokePath, 
TDC::StrokeAndFillPath, TDC::SetPolyFillMode 

inline BOOL FiilRect (-int xl, int x2, int yl, int y2, const TBrushk brush); 
inline BOOL FiilRect (const TRect& rect, const TBrush& brush); 

Fills the given rectangle on this DC using the specified brush. The fill 
covers the left and top borders but excludes the right and bottom borders. 
FiilRect returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: ::FillRect 

inline BOOL FillRgn(const TRegionk region, const TBrush& brush); 

Fills the given region on this DC using the specified brush. FillRgn returns 
TRUE if the call is successful; otherwise, it returns FALSE. 
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FloodFill 



FrameRect 



See also: TDC::InvertRgn, TDCr.PaintRgn, ::FillRgn 

FlattenPath inline BOOL FlattenPathO; 

Transforms any curves in the currently selected path of this DC. All such 
curves are changed to sequences of linear segments. Returns TRUE if the 
call is successful; otherwise returns FALSE. 

See also: ::FlattenPath, TDC::VJidenPath, TDC::BeginPath 

inline BOOL FloodFill (const TPointk point, TColor color); 

Fills an area on this DC starting at point and using the currently selected 
brush object. The color argument specifies the color of the boundary or of 
the area to be filled. Returns TRUE if the call is successful; otherwise, 
returns FALSE. FloodFill is maintained in the WIN32 API for compatibility 
with earlier APIs. New WIN32 applications should use TDC::ExtFloodFill(). 

See also: TDC::ExtFloodFill, ::FloodFill 

inline BOOL FrameRect (int xl, int x2, int yl, int y2, 

const TBrush& brush) ; 
inline BOOL FrameRect (const TRect& rect, const TBrush& brush); 

Draws a border on this DC around the given rectangle using the given 
brush. The height and width of the border is one logical unit. Returns 
TRUE if the call is successful; otherwise returns FALSE. 

See also: ::FrameRect 

FrameRgn inline BOOL FrameRgn( const TRegionk region, const TBrush& brush, 

const TPointk p) ; 

Draws a border on this DC around the given region, region, using the given 
brush, brush. The width and height of the border is specified by the p 
argument. Returns TRUE if the call is successful; otherwise, returns FALSE. 

See also: ::FrameRgn 

GetAspectRatioFilter inline. BOOL GetAspectRatioFilter(TSize& size) const; 

Retrieves the setting of the current aspect-ratio filter for this DC. 

See also: ::GetAspectRatioFilter, r.SetMapperFlags 

inline TColor GetBkColorO const; 

Returns the current background color of this DC. 

See also: TDC::SetBkColor, ::GetBkColor 

inline int GetBkModeO const; 



GetBkColor 



GetBkMode 
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GetBoundsRect 



Returns the background mode of this DC, either OPAQUE or 
TRANSPARENT. 

See also: TDCr.SetBkMode, ::GetBkMode 

inline BOOL GetBoundsRect (TRect& bounds, WORD flags) const; 

Reports in bounds the current accumulated bounding rectangle of this DC 
or of the Windows manager, depending on the value of flags. Returns TRUE 
if the call is successful; otherwise returns FALSE. 

The flags argument can be DCB_RESET or DCB_WINDOWMGR or both. 
The flags value work as follows: 



GetBrushOrg 



DCB_RESET 

DCB WINDOWMGR 



Forces the bounding rectangle to be cleared after being set in bounds. 

Reports the Windows current bounding rectangle rather than that of this 
DC. 



There are two bounding-rectangle accumulations, one for Windows and 
one for the application. GetBoundsRect returns screen coordinates for the 
Windows bounds, and logical units for the application bounds. The 
Windows accumulated bounds can be queried by an application but not 
altered. The application can both query and alter the DCs accumulated 
bounds. 

See also: TDC::SetBoundsRect, -.-.GetBoundsRect 

inline BOOL GetBrushOrg (TPoint& point) const; 

Places in -point the current brush origin of this DC. Returns TRUE if 
successful; otherwise returns FALSE. 



See also: TDCr.SetBrushOrgEx 

GetCharABCWidthS inline BOOL GetCharABCWidths(UINT firstChar, UINT lastChar, ABC* abc); 

Retrieves the widths of consecutive characters in the range firstChar to 
lastChar from the current TrueType font of this DC. The widths are reported 
in the array abc of ABC structures. Returns TRUE if the call is successful; 
otherwise returns FALSE. 



GetCharWidth 



See also: ::GetCharABCWidths r ABC struct, TDCr.GetCharWidth 

inline BOOL GetCharWidth (UINT firstChar, UINT lastChar, int* buffer) ; 

Retrieves the widths in logical units for a consecutive sequence of 
characters in the current font for this DC. The sequence is specified by the 
inclusive range, firstChar to lastChar, and the widths are copied to the given 
buffer. If a character in the range is not represented in the current font, the 
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width of the default character is assigned. Returns TRUE if the call is 
successful; otherwise returns FALSE. 

See also: ::GetChar Width, TDCr.GetCharABCWidths 

GetClipBox inline int GetClipBox (TRect& rect) const; 

inline TRect GetClipBox () const; 

Places the current clip box size of this DC in rect. The clip box is defined as 
the smallest rectangle bounding the current clipping boundary. The return 
value indicates the clipping region's type as follows: 



Region 



Meaning 



GetClipRgn 



GetCurrentObject 




GetCurrentPosition 



GetDCOrg 



COMPLEXREGION Clipping Region has overlapping borders. 

ERROR Invalid DC. 

NULLREGION Clipping region is empty. 

SIMPLEREGION Clipping region has no overlapping borders. 

See also: r.GetClipBox, TDCr.ExcludeClipRect 

inline BOOL GetClipRgn (TRegion& region) const; 

Retrieves this DCs current clip-region and, if successful, places a copy of it 
in the region argument. You can alter this copy without affecting the current 
clip-region. Returns TRUE if the call is successful; otherwise returns 
FALSE. 

See also: r.GetClipRgn 

inline HANDLE GetCurrentObject (UINT objectType) const; 

Returns a handle to the currently selected object of the given objectType 
associated with this DC. Returns if the call fails. objectType can be 
OBJ_PEN, OBJ_BRUSH, OBJ_PAL, OBJ_FONT, or OBJ_BITMAP. 

See also: y.GetObject, ::SelectObject 

inline BOOL GetCurrentPosition (TPointk point) const; 

Reports in point the logical coordinates of this DCs current position. 
Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: ::GetCurrentPosition 

inline BOOL GetDCOrg (TPointk point) const; 

Obtains the final translation origin for this device context and places the 
value in point. This value specifies the offset used to translate device 
coordinates to client coordinates for points in an application window. 
Returns TRUE if the call is successful; otherwise returns FALSE. 
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GetDeviceCaps 



GetDIBits 



See also: ::GetDCOrg 

inline virtual int GetDeviceCaps (int index) const; 

Used under WIN3.1 or later, GetDeviceCaps returns capability information 
about this DC. The index argument specifies the type of information 
required. 

See also: -.-.GetDeviceCaps 

inline BOOL GetDIBits (const TBitmap& bitmap, WORD startScan, 
WORD numScans, void HUGE* bits, 
const BITMAPINFO far& info, WORD usage); 

inline BOOL GetDIBits (const TBitmap& bitmap, TDib& dib); 

The first version retrieves some or all of the bits from the given bitmap on 
this DC and copies them to the bits buffer using the DIB (device- 
independent bitmap) format specified by the BITMAPINFO argument, info. 
numScan scanlines of the bitmap are retrieved, starting at scanline startScan. 
The usage argument determines the format of the bmiColors member of the 
BITMAPINFO structure, according to the following table: 



Value 



Meaning 



GetFontData 



DIB_PAL_COLORS 

DIB_RGB_COLORS 
DIB PAL INDICES 



The color table is an array of 16-bit indices into the current logical 
palette. 

The color table contains literal RGB values. 

There is no color table for this bitmap. The DIB bits consist of indices 
into the system palette. No color translation occurs. Only the 
BITMAPINFOHEADER portion of BITMAPINO is filled in. 

In the second version of GetDIBits, the bits are retrieved from bitmap and 
placed in the dib Bits data member of the given TDib argument. The 
BITMAPINFO argument is supplied from dib.info. 

GetDIBits returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: TDCr.SetDIBits, -.-.GetDIBits, TDibr.info 

inline DWORD GetFontData (DWORD table, DWORD offset, void* buffer, 

long data) ; 

Retrieves font-metric information from a scalable TrueType font file 
(specified by table and starting at offset into this table) and places it in the 
given buffer, data specifies the size in bytes of the data to be retrieved. If the 
call is successful, it returns the number of bytes set in buffer; otherwise, -1 is 
returned. 

See also: -.-.GetFontData 
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GetKemingPairs inline int GetKerningPairs(int pairs, KERNINGPAIR far* krnPair); 

Retrieves up to pairs of the kerning pairs for the current font of this DC and 
copies them into the krnPair array of KERINGPAIR structures. If successful, 
the function returns the actual number of pairs retrieved. If the font has 
more than pairs kerning pairs, the call fails and returns 0. The krnPair array 
must allow for at least pairs KERNINGPAIRS structures. If krnPair is set to 
0, GetKemingPairs returns the total number of kerning pairs for the current 
font. 

See also: : -.GetKemingPairs, KERNINGPAIR struct 

GetMapMode inline int GetMapModeO const; 

If successful, GetMapMode returns the current window mapping mode of 
this DC; otherwise, it returns 0. The mapping mode defines how logical 
coordinates are mapped to device coordinates. It also controls the 
orientation of the device's x- and y-axes. The mode values are shown in the 
following table: 



Value 



Meaning 



.ANISOTROPIC Logical units are mapped to arbitrary units with arbitrarily scaled 

axes. The SetWihdowExtEx and SetViewportExtEx functions must be 
used to specify the desired units, orientation, and scaling. 

_HIENGUSH Each logical unit is mapped to 0.001 inch. Positive x is to the right; 

positive y is at the top. 

_HIMETRIC Each logical unit is mapped to 0.01 millimeter. Positive x is to the 

right; positive y is at the top. 

.ISOTROPIC Logical units are mapped to arbitrary units with equally scaled axes; 

that is, one unit along the x-axis is equal to one unit along the y-axis. 
The Set WindowExtEx and SetViewportExtEx functions must be used 
to specify the desired units and the orientation of the axes. GDI 
makes adjustments as necessary to ensure that the x and y units 
remain the same size (e.g., if you set the window extent, the viewport 
is adjusted to keep the units isotropic). 

_LOENGLISH Each logical unit is mapped to 0.01 inch. Positive x is to the right; 

positive y is at the top. 

10METRIC Each logical unit is mapped to 0.1 millimeter. Positive x is to the right; 

positive y is at the top. 

JEXT Each logical unit is mapped to one device pixel. Positive x is to the 

right; positive y is at the bottom. 

JWIPS Each logical unit is mapped to one twentieth of a printer's point 

(1/1440 inch). Positive x is to the right; positive y is at the top. 
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See also: TDCr.SetMapMode, r.GetMapMode 

GetNearestColor inline TColor GetNearestColor(TColor Color) const; 

Returns the nearest color to the given Color argument for the current 
palette of this DC. 



See also: : -.GetNearestColor 



GetOutlineTextMetrics 




GetPixel 



GetPolyFillMode 



GetR0P2() 



GetStretchBltMode 



inline DWORD GetOutlineTextMetrics (UINT data, 

OUTLINETEXTMETRIC far& otm); 
inline WORD GetOutlineTextMetrics (UINT data, 

OUTLINETEXTMETRIC far& otm); 

Retrieves metric information for TrueType fonts on this DC and copies it to 
the given array of OUTLINETEXTMETRIC structures, otm. This structure 
contains a TEXTMETRIC and several other metric members, as well as four 
string-pointer members for holding family, face, style, and full font names. 
Since memory must be allocated for these variable-length strings in 
addition to the font metric data, you must pass (via the data argument) the 
total number of bytes required for the retrieved data. If 
GetOutlineTextMetrics is called with otm = 0, the function returns the total 
buffer size required. You can then assign this value to data in subsequent 
calls. 

The WIN32 version returns a DWORD value. 

Returns nonzero if the call is successful; otherwise, returns 0. 

See also: -GetOutlineTextMetrics, OUTLINETEXTMETRICS struct, 
TCDv.GetTextMetrics 

inline TColor GetPixel (int x, int y) const; 
inline TColor GetPixel (const TPoint& point) const; 

Returns the color of the pixel at the given location. 

See also: TDC::SetPixel, r.GetPixel 

inline int GetPolyFillMode () const; 

Returns the current polygon-filling mode for this DC, either ALTERNATE 
or WINDING. 

See also: TDC::SetPolyFillMode r ::GetPolyFillMode 

inline int GetR0P2() const; 

Returns the current drawing (raster operation) mode of this DC. 

See also: TDC::SetROP2(),::GetROP2 

■inline int GetStretchBltMode ( ) const; 
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Returns the current stretching mode for this DC: BLACKONWHITE, 
COLORONCOLOR, or WHITEONBLACK. The stretching mode 
determines how bitmaps are stretched or compressed by the StretchBlt 
function. 

See also: TDC::SetStretchBHMode, ;:GetStretchBHMode, TDC: -.StretchBlt 

GetSystemPaletteEntrieS inline UINT GetSystemPaletteEntries(int start, int num, 
PALETTEENTRY far* entries) const; 

Retrieves a range of up to num palette entries, starting at start, from the 
system palette to the entries array of PALETTEENTRY structures. Returns 
the actual number of entries transferred. 

See also: r.GetSystemPaletteEntries 

GetSystemPaletteUse inline UINT GetSystemPaletteUseO const; 

Determines whether this DC has access to the full system palette. Returns 
SYSPAL_NOSTATIC or SYSPAL_STATIC. 

See also: TDC::SetSystemPaletteUse, ::GetSystemPaletteUse 

GetTabbedTextExtent inline BOOL GetTabbedTextExtent (const char far* string, int stringLen, 

int numPositions, const int* positions, 
TSize& size) const; 
inline TSize GetTabbedTextExtent (const char far* string, int stringLen, 

int numPositions, 
const int* positions) const; 

Computes the extent (width and height) in logical units of the text line 
consisting of stringLen characters from the null-terminated string. The 
extent is calculated from the metrics of the current font or this DC, but 
ignores the current clipping region. In the first version of 
GetTabbedTextExtent, the extent is returned in size; in the second version, the 
extent is the returned TSize object. Width is size.x and width is size.y . 

The width calculation includes the spaces implied by any tab codes in the 
string. Such tab codes are interpreted using the numPositions and positions 
arguments. The positions array specifies numPositions tab stops given in 
device units. The tab stops must have strictly increasing values in the array. 
If numPositions and positions are both 0, tabs are expanded to eight times the 
average character width. If numPositions is 1, all tab stops are taken to be 
positions[0] apart. 

If kerning is being applied, the sum of the extents of the characters in a 
string might not equal the extent of the string. 

See also: -.-.GetTabbedTextExtent, TDC::TabbedTextOut, TDCr.GetTextExtent 
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inline UINT GetTextAlign () const; 

If successful, GetTextAlign returns the current text-alignment flags for this 
DC; otherwise, it returns the value GDI_ERROR. The text-alignment flags 
determine how TDC::TextOut() and TDC::ExtTextOut align text strings in 
relation to the first character's screen position. GetTextAlign returns certain 
combinations of the flags listed in the following table: 



Value 


Meaning 


TA_BASELINE 


The reference point will be on the baseline of the text. 


TA_BOTTOM 


The reference point will be on the bottom edge of the bounding 
rectangle. 


TA_TOP 


The reference point will be on the top edge of the bounding rectangle. 


TA_CENTER 


The reference point will be aligned horizontally with the center of the 
bounding rectangle. 


TA_LEFT 


The reference point will be on the left edge of the bounding rectangle. 


TA_RIGHT 


The reference point will be on the right edge of the bounding rectangle. 


TA_NOUPDATECP 


The current position is not updated after each text output call. 


TAJJPDATECP 


The current position is updated after each text output call. 




When the current font has a vertical default baseline (as with Kanji) the 
following values replace TA_BASELINE and TA_CENTER: 




VTA_BASELINE The reference point will be on the baseline of 
the text. 




VTA_CENTER The reference point will be aligned vertically 
with the center of the bounding rectangle. 



The text-alignment flags are not necessarily single bit-flags and might be 
equal to 0. The flags must be examined in groups of the following related 
flags: 

■ TA_LEFT, TA_RIGHT, and TA_CENTER 

■ TA_BOTTOM, TA_TOP, and TA_BASELINE 

■ TAJMOUPDATECP and TAJJPDATECP 

If the current font has a vertical default baseline (as with Kanji), these are 
groups of related flags: 

■ TA_LEFT, TA_RIGHT, and VTA_BASELINE 

■ TA_BOTTOM, TA_TOP, and VTA_CENTER 

■ TA NOUPDATECP and TA UPDATECP 
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To verify that a particular flag is set in the return value of this function, the 
application must perform the following steps: 

1. Apply the bitwise OR operator to the flag and its related flags. 

2. Apply the bitwise AND operator to the result and the return value. 

3. Test for the equality of this result and the flag. 

The following example shows a method for determining which horizontal 
alignment flag is set: 

switch ((TA_LEFT I TA_RIGHT I TA_CENTER) & dc.GetTextAlignO ) { 
case TA_LEFT: 

case TA_RIGHT: 

case TA CENTER: 



GetTextColor 



GetTextExtent 



GetTextFace 



See also: TDC::SetText Align, ::GetText Align, TDCr.TextOut, 
TDC::ExtTextOut 

inline TColor GetTextColor () const; 

Returns the current text color of this DC. The text color determines the 
color displayed by TDC::TextOut() and TDC::ExtTextOut(). 

See also: TDC::SetTextColor, -.-.GetTextColor, TDCr.TextOut, TDCr.ExtTextOut 

inline BOOL GetTextExtent (const char far* string, int stringLen, 

TSize& size) ; 
inline TSize GetTextExtent (const char far* string, int stringLen); 

Computes the extent (width and height) in logical units of the text line 
consisting of stringLen characters from the null-terminated string. The 
extent is calculated from the metrics of the current font or this DC, but 
ignores the current clipping region. In the first version of GetTextExtent the 
extent is returned in size; in the second version, the extent is the returned 
TSize object. Width is size.x and width is size.y. 

If kerning is being applied, the sum of the extents of the characters in a 
string might not equal the extent of the string. 

GetTextExtent is not supported under WIN32. WIN32 applications should 
use TDCr.GetTextExtentPoint. 

See also: -.-.GetTextExtent, TDCr.GetTextExtentPoint 

inline int GetTextFace (int count, char far* facename) const; 
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Retrieves the typeface name for the current font on this DC. Up to count 
characters of this name are copied to facename. If successful, GetTextFace 
returns the number of characters actually copied; otherwise, it returns 0. 

See also: -/.GetTextFace, TDCv.GetText Align, TDC::GetTextMetrics 

GetTextMetricS inline BOOL GetTextMetrics(TEXTMETRIC far& metrics) const; 

Fills the metrics structure with metrics data for the current font on this DC. 
Returns TRUE if the call is successful; otherwise, returns FALSE. 

See also: ::GetTextMetrics,TEXTMETRIC struct 

DWORD GetGlyphOutline(UINT chr, UINT format, GLYPHMETRICS far& gm, 
DWORD buffSize, void far* buffer, 
const MAT2 far& mat 2) ; 

Retrieves TrueType metric and other data for the given character, chr, on 
this DC and places it in gm and buffer. The format argument specifies the 
format of the retrieved data as follows: 



Value 



Meaning 



1 Retrieves the glyph bitmap. 

2 Retrieves the curve data points in the rasterizer's native format and uses the font's 
design units. With this value of format, the mat2 transformation argument is ignored. 

The gm argument specifies the GLYPHMETRICS structure that describes 
the placement of the glyph in the character cell. buffSize specifies the size of 
buffer that receives data about the outline character. If either buffSize or 
buffer are 0, GetGlyphOutline returns the required buffer size. Applications 
can rotate characters retrieved in bitmap format (format = 1) by specifying a 
2x2 transformation matrix via the mat! argument. 

GetGlyphOutline returns a positive number if the call is successful; 
otherwise, it returns GDI_ERROR. 

See also: : -.GetGlyphOutline, GLYPHMETRICS struct, 
TDC::GetOutlineTextMetrics 

GetViewportExt inline BOOL GetViewportExt (TSize& extent) const; 

inline TSize GetViewportExt ( ) const; 

The first version retrieves this DCs current viewport's x- and y-extents (in 
device units) and places the values in extent. This version returns TRUE if 
the call is successful; otherwise, it returns FALSE. The second version 
returns only these x- and y-extents. 

The extent value determines the amount of stretching or compression 
needed in the logical coordinate system to fit the device coordinate system. 
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GetViewportOrg 



GetWindowExt 



GetWindowOrg 



GrayString 



extent also determines the relative orientation of the two coordinate 
systems. 

See also: TDCr.SetViewportExt, r.GetViezvportExt 

inline BOOL GetViewportOrg (TPointk point) const; 
inline TPoint GetViewportOrg () const; 

The first version sets in the point argument the x- and y-extents (in device- 
units) of this DCs viewport. It returns TRUE if the call is successful; 
otherwise, it returns FALSE. The second version returns the x- and y- 
extents (in device-units) of this DCs viewport. 

See also: TDCr.SetViewportOrg, TDC::OffsetViewportOrg, : .-GetViewportOrg 

inline BOOL GetWindowExt (TSize& extent) const; 
inline TSize GetWindowExt ( ) const; 

Retrieves this DCs window current x- and y-extents (in device units). The 
first version places the values in extent and returns TRUE if the call is 
successful; otherwise, it returns FALSE. The second version returns the 
current extent values. The extent value determines the amount of stretching 
or compression needed in the logical coordinate system to fit the device 
coordinate system, extent also determines the relative orientation of the two 
coordinate systems. 

See also: TDC::SetWindowExt, : -.GetWindowExt 

inline BOOL GetWindowOrg (TPointk point) const; 
inline TPoint GetWindowOrg ( ) const; 

Places in point the x- and yrcoordinates of the origin of the window 
associated with this DC. Returns TRUE if the call is successful; otherwise 
returns FALSE. 

See also: TDC::SetWindowOrg, TDCr.OffsetWindowOrg, -.-.GetWindowOrg 

inline virtual BOOL GrayString (const TBrushk brush, 

GRAYSTRINGPROC outputFunc, 

const char far* string, int count, 

const TRect& r) ; 

Draws in the given rectangle (r) up to count characters of gray text from 
string using the given brush and the current font for this DC. If count is -1 
and string is null-terminated, the whole string is written. The rectangle 
must be specified in logical units. If brush is 0, the text is grayed with the 
same brush used to draw window text on this DC. Gray text is primarily 
used to indicate disabled commands and menu items. 
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GrayString writes the selected text to a memory bitmap, grays the bitmap, 
then displays the result. The graying is performed regardless of the current 
brush and background color. 

The outputFunc pointer-to-function can specify the procedure-instance of an 
application-supplied drawing function. If outputFunc is 0, GrayString uses 
TextOut and string is assumed to be a normal, null-terminated character 
string. If string cannot be handled by TextOut (for example, if the string is 
stored as a bitmap), you must provide a suitable drawing function via 
outputFunc. 

If the device supports a solid gray color, it is possible to draw gray strings 
directly without using GraySring. Call GetSysColor to find the color value; 
for example, G of COLOR_GRAYTEXT. If G is nonzero (non-black), you can 
set the text color with SetTextColor(G) and then use any convenient text- 
drawing function. 

GrayString returns TRUE if the call is successful; otherwise, it returns 
FALSE. Failure can result if TextOut or outputFunc return FALSE, or if there 
is insufficient memory to create the bitmap. 

See also: -.-.GrayString, TDC::TextOut 

int IntersectClipRect (const TRect& rect); 

Creates a new clipping region for this DCs window by forming the 
intersection of the current region with the rectangle specified by rect. The 
return value indicates the resulting clipping region's type as follows: 



InvertRect 



InvertRgn 



Region 



Meaning 



COMPLEXREGION Clipping Region has overlapping borders. 

ERROR Invalid DC. 

NULLREGION Clipping region is empty. 

SIMPLEREGION Clipping region has no overlapping borders. 

See also: TDC::GetClipBox, -.-.IntersectClipRect 

inline BOOL InvertRect (int xl, int x2, int yl, int y2); 
inline BOOL InvertRect (const TRect& rect); 

Inverts the given rectangle on this DC. On monochrome displays, black and 
white pixels are interchanged. On color displays, inversion depends on 
how the colors are generated for particular displays. Calling InvertRect an 
even number of times restores the original colors. InvertRect returns TRUE 
if the call is successful; otherwise, it returns FALSE. 

See also: -.-.InvertRect 

inline BOOL InvertRgn (const TRegionk region); 
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LineDDA 



LineTo 



LPtoDP 



Inverts the given region, on this DC. On monochrome displays, black and 
white pixels are interchanged. On color displays, inversion depends on 
how the colors are generated for particular displays. Calling InvertRegion an 
even number (n>=2 ) of times restores the original colors. Returns TRUE if 
the call is successful; otherwise, it returns FALSE. 

See also: TDCr.PaintRgn, TDCr.FillRgn, y.InvertRgn 

inline BOOL LineDDA (int xl, int yl, int x2, int y2, 'LINEDDAPROC proc, 

LPARAM lParam) ; 
inline BOOL TextRect (const TPointk pi, const TPointk p2, LINEDDAPROC proc, 
LPARAM 1 Par am) ; 

Determines which pixels should be highlighted for a line given by the start 
{xl, yl or point pi) and end {xl, yl or point pi) point arguments. Each point 
along the path (excluding the end point) is passed to the user-defined 
Callback function, proc, together with the optional user-supplied data via 
War am. The proc argument must be of type pointer to LineDDAFunc, a 
function declared as 

void CALLBACK LineDDAFunc (int x, int y, LPARAM lParam) ; 

where x and y specify the current point in the path. 

LineDDA returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: ::LineDDA 

inline BOOL LineTo(int x, int y) ; 
inline BOOL LineTo(const TPointk point); 

Draws a line on this DC using the current pen object. The line is drawn 
from the current position up to, but not including, the given end point, 
which is specified by {x, y) or by point. If the call is successful, LineTo 
returns TRUE and the current point is reset to point; otherwise, it returns 
FALSE. 

See also: r.LineTo 

inline BOOL LPtoDP (TPoint* points, int count - 1) const; 

Converts each of the count points in the points array from logical points to 
device points. The conversion depends on this DCs current mapping mode 
and the settings of its window and viewport origins and extents. Returns 
TRUE if the call is successful; otherwise, it returns FALSE. 

See also: TDC::DPtoLP, ::LPtoDP 
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inline BOOL MaskBIt (const TRect& dst, const TDC& srcDC, const TPoint& src, 
const TBitmap& maskBm, const TPoint& maskPos, 
DWORD rop) ; 

Copies a bitmap from the given source DC to this DC. MaskBIt combines 
the color data from source and destination bitmaps using the given mask 
and raster operation. The srcDC argument specifies the DC from which the 
source bitmap will be copied. The destination bitmap is given by the 
rectangle, dst . The source bitmap has the same width and height as dst . The 
src argument specifies the logical coordinates of the upper left corner of the 
source bitmap. The maskBm argument specifies a monochrome mask 
bitmap. An error will occur if maskBm is not monochrome. The maskPos 
argument gives the upper left corner coordinates of the mask. The raster- 
operation code, rop, specifies how the source, mask, and destination 
bitmaps combine to produce the new destination bitmap. The raster- 
operation codes are as follows: 



Value of rop 



Meaning 



BLACKNESS Fill dst with index-0 color of physical palette (default is black). 

DSTINVERT Invert tfsf. 

MERGECOPY Merge the colors of source with mask with Boolean AND. 

MERGEPAINT Merge the colors of inverted-source with the colors of dst using Boolean 

OR. 

NOTSRCCOPY Copy inverted-source to dst. 

NOTSRCERASE Combine the colors of source and dst using Boolean OR, then invert 

result. 

PATCOPY Copy mask to dst. 

PATINVERT Combine the colors of mask with the colors of dst using Boolean XOR. 

PATPAINT Combine the colors of mask with the colors of inverted-source using 

Boolean OR, then combine the result with the colors of dst using Boolean 
OR. 

SRCAND Combine the colors of source and dst using the Boolean AND. 

SRCCOPY Copy source directly to dst. 

SRCERASE Combine the inverted colors of dst with the colors of source using 

Boolean AND. 

SRCPAINT Combine the colors of source and dst using Boolean OR. 

WHITENESS Fill dst with index-1 color of physical palette (default is white). 



114 



ObjectWindows 2.0 Reference Guide 



TDC class 



If rop indicates an operation that excludes the source bitmap, the srcDC 
argument must be 0. A value of 1 in the mask indicates that the destination 
and source pixel colors should be combined using the high-order word of 
rop. A value of in the mask indicates that the destination and source pixel 
colors should be combined using the low-order word of rop. If the mask 
rectangle is smaller than dst, the mask pattern will be suitably duplicated. 

When recording an enhanced metafile, an error occurs if the source DC 
identifies the enhanced metafile DC. 

If a rotation or shear transformation is in effect for the source DC when 
MaskBlt is called, an error occurs. Other transformations are allowed. If 
necessary, MaskBlt will adjust the destination and mask color formats to 
match that of the source bitmaps. Before using MaskBlt, an application 
should call GetDeviceCaps to determine if the source and destination DCs 
support MaskBlt. 

MaskBlt returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: r.MaskBlt, TDC::BUBlt, TDC::PlgBlt, TDC::GetDeviceCaps 

ModifyWorldTransform inline BOOL Modi fyWorldTrans form (XFORM far& xform, DWORD mode); 

Changes the current world transformation for this DC using the given 
xform and mode arguments, mode determines how the given XFORM 
structure is applied, as listed below. 

Value Meaning 

MWTJDENTITY Resets the current world transformation using the identity matrix. 

If this mode is specified, the XFORM structure pointed to by 
IpXform is ignored. 

MWT_LEFTMULTIPLY Multiplies the current transformation by the data in the XFORM 

structure. (The data in the XFORM structure becomes the left 
multiplicand, and the data for the current transformation becomes 
the right multiplicand.) 

MWT_RIGHTMULTIPLY Multiplies the current transformation by the data in the XFORM 

structure. (The data in the XFORM structure becomes the right 
multiplicand^ and the data for the current transformation 
becomes the left multiplicand.) ModifyWorldTransform returns 
TRUE if the call is successful; otherwise, it returns FALSE. 

See also: TDC::SetWorldTransform, : -.ModifyWorldTransform 

MoveTo inline BOOL MbveTo ( int x, int y); 

inline BOOL MoveTo (const TPointk point); 

inline BOOL MoveTo(const TPoint& point, TPoint& oldPoint) ; 
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Moves the current position of this DC to the given x- and y-coordinates or 
to the given point. The third version, corresponding to ::MoveToEx, sets the 
previous current position in oldPoint. Returns TRUE if the call is successful; 
otherwise returns FALSE. 

See also: ::MoveTo, ::MoveToEx 

inline int OffsetClipRgn (const TPoint& delta); 

Moves the clipping region of this DC by the x- and y-offsets specified in 
delta. The return value indicates the resulting clipping region's type as 
follows: 



OffsetViewportOrg 



Region 



Meaning 



COMPLEXREGION Clipping region has overlapping borders. 

ERROR Invalid DC. 

NULLREGION Clipping region is empty. 

SIMPLEREGION Clipping region has no overlapping borders. 

See also: r.OffsetClipRgn, TDC::GetClipBox 

inline virtual BOOL OffsetViewportOrg (const TPoint& delta, TPoint* oldOrg 



Modifies this DCs viewport origin relative to the current values. The delta 
x- and y-components are added to the previous origin and the resulting 
point becomes the new viewport origin. The previous origin is saved in 
oldOrg. Returns TRUE if the call is successful; otherwise, returns FALSE. 

See also: TDC::SetVieu>portOrg, TDCr.GetViewportOrg, -.-.OffsetViewportOrg 

OffsetWindOWOrg inline BOOL OffsetWindowOrg( const TPoint& delta, TPoint* oldOrg = 0); 

Modifies this DCs window origin relative to the current values. The delta 
x- and y-components are added to the previous origin and the resulting 
point becomes the new window origin. The previous origin is saved in 
oldOrg. Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: TDC::GetWindozvOrg, TDCr.SetWindowOrg, ::OffsetWindowOrg 

operator HDC() operator HDC() const {return Handle;} 

Typecasting operator. Converts a pointer to type HDC (the Windows data 
type representing the handle to a DC). 

PaintRgn inline BOOL PaintRgn( const TRegionk region) ; 

Paints (fills) the given region on this DC using, the currently selected brush. 
Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: TDCr.FillRgn, -.-.PaintRgn, TDCr.SelectObject 
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inline BOOL PatBIt (int x, int y, int w, int h, DWORD rop); 
inline BOOL PatBlt(const TRect& dst, DWORD rop); 

Paints the given rectangle using the currently selected brush for this DC. 
The rectangle can be specified by its upper left coordinates (x, y), width w, 
and height h, or by a single TRect argument. The raster-operation code, rop, 
determines how the brush and surface color(s) are combined, as explained 
in the following table: 



Value 



Meaning 



PathToRegion 




Pie 



PATCOPY Copies pattern to destination bitmap. 

PATINVERT Combines destination bitmap with pattern using the Boolean OR operator. 

DSTINVERT Inverts the destination bitmap. 

BLACKNESS Turns all output to binary Os. 

WHITENESS Turns all output to binary 1s. 

The allowed values of rop for this function are a limited subset of the full 
256 ternary raster-operation codes; in particular, an operation code that 
refers to a source cannot be used with PatBIt. 

Not all devices support the PatBIt function, so applications should call 
TDCr.GetDeviceCaps to check the features supported by this DC. 

PatBIt returns TRUE if the call is successful; otherwise returns FALSE. 

See also: r.PatBlt, TDCr.GetDeviceCaps 

inline HRGN PathToRegion () ; 

If successful, PathToRegion returns a region created from the closed path in 
this DC; otherwise, it returns 0. 

See also: "PathToRegion 

inline BOOL Pie (int xl, int yl, int x2, int y2, int x3, int y3, int x4, 

int y4); 
inline BOOL Pie (const TRect& rect, const TPointk start, 

const TPoint& end) ; 

Using the currently selected pen and brush objects, draws and fills a pie- 
shaped wedge by drawing an elliptical arc whose center and end points are 
joined by lines. The center of the ellipse is the center of the rectangle 
specified either by (xl,yl)/(x2, yl) or by the rect argument. The 
starting/ending points of pie are specified either by (x3, y3)/(x4, y4) or by 
the points Start and End. Returns TRUE if the call is successful; otherwise, 
returns FALSE. The current position is neither used nor altered by this call. 
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See also: ::Pie, TDC::Chord, TDC::Arc 

PlayMetaFile inline BOOL PlayMetaFile.f const TMetaFilePictfc metaFile) ; 

Plays the contents of the given metaFile on this DC. The metafile can be 
played any number of times. Returns TRUE if the call is successful; 
otherwise returns FALSE. 

See also: ::Play MetaFile, TDC::EnumMetaFile, TDC: -.PlayMetaFileRecord 

PlayMetaFileRecord inline void PlayMetaFileRecord(HANDLETABLE far& Handletable, 

METARECORD far& metaRecord, int count); 

Plays the metafile record given in metaRecord to this DC by executing the 
GDI function call contained in that record. Handletable specifies the object 
handle table to be used, count specifies the number of handles in the table. 



PlgBIt 




See also: : -.PlayMetaFileRecord, TDCr.PlayMetaFile, TDCr.EnumMetaFile 

inline BOOL PlgBIt (const TPoint& dst, const TDC& srcDC, const TRect& src, 
const TBitmap& maskBm, const TPoint& maskPos, 
DWORD rop) ; 

Performs a bit-block transfer from the given source DC to this DC. Color 
bits are copied from the src rectangle on srcDC, the source DQ to the 
parallelogram dst on this DC. The dst array specifies three points A, B, and 
C as the corners of the destination parallelogram. The fourth point D is 
generated internally from the vector equation D = B + C - A. The upper left 
corner of src is mapped to A, the upper right corner to B, the lower left 
corner to C, and the lower right corner to D. An optional monochrome 
bitmap can be specified by the maskBm argument. (If maskBm specifies a 
valid monochrome bitmap, PlgBIt uses it to mask the color bits in the 
source rectangle. An error occurs if maskBm is not a monochrome bitmap.) 
maskPos specifies the upper left corner coordinates of the mask bitmap. 
With a valid maskBm, a value of 1 in the mask causes the source color pixel 
to be copied to dst; a value of in the mask indicates that the corresponding 
color pixel in dst will not be changed. If the mask rectangle is smaller than 
dst, the mask pattern will be suitably duplicated. 

The destination coordinates are transformed according to this DC (the 
destination DC). The source coordinates are transformed according to the 
source DC. If a rotation or shear transformation is in effect for the source 
DC when PlgBIt is called, an error occurs. Other transformations, such as 
scaling, translation, and reflection are allowed. The stretching mode of this 
DC (the destination DC) determines how PlgBIt will stretch or compress the 
pixels if necessary. When recording an enhanced metafile, an error occurs if 
the source DC identifies the enhanced metafile DC. 
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PolyBezier 




PolyBezierTo 




PolyDraw 




If necessary, PlgBlt adjusts the source color formats to match that of the 
destination. An error occurs if the source and destination DCs are 
incompatible. Before using PlgBlt, an application should call GetDeviceCaps 
to determine if the source and destination DCs are compatible. 

PlgBlt returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: r.PlgBlt, TDCr.GetDeviceCaps, TDCr.SetStretchBUMode, MaskBlt, 
TDCr.StretchBlt 

inline BOOL PolyBezier (const TPoint* points, int count); 

Draws one or more connected cubic Bezier splines through the points 
specified in the points array using the currently selected pen object. The first 
spline is drawn from the first to the fourth point of the array using the 
second and third points as controls. Subsequent splines, if any, each require 
three additional points in the array, since the previous end point is taken as 
the next spline's start point. The count argument ( >= 4 ) specifies the total 
number of points needed to specify the complete drawing. To draw n 
splines, count must be set to (3n + 1). Returns TRUE if the call is successful; 
otherwise returns FALSE. The current position is neither used nor altered 
by this call. The resulting figure is not filled. 

See also: TDC::PolyBezierTo, r.PolyBezier 

inline BOOL PolyBezierTo (const TPoint* points, int count); 

Draws one or more connected cubic Bezier splines through the points 
specified in the points array using the currently selected pen object. The first 
spline is drawn from the current position to the third point of the array 
using the first and second points as controls. Subsequent splines, if any, 
each require three additional points in the array, since the previous end 
point is taken as the next spline's start point. The count argument ( >= 4 ) 
specifies the total number of points needed to specify the complete 
drawing. To draw n splines, count must be set to 3n. Returns TRUE if the 
call is successful; otherwise returns FALSE. The current position is moved 
to the end point of the final Bezier curve. The resulting figure is not filled. 

See also: TDCr.PolyBezier, -.-.PolyBezierTo 

inline BOOL PolyDraw (const TPoint* points, BYTE* types, int count); 

Draws one or more, possibly disjoint, sets of line segments and/or Bezier 
splines on this DC using the currently selected pen object. The count points 
in the points array provide the end points for each line segment and/or the 
end points and control points for each Bezier spline. The count BYTEs in the 
types array determine how the corresponding point in points is to be 
interpreted: 
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Polygon 



Polyline 



Byte Meaning 

PT_BEZIERTO This point is a control or end point for a Bezier spline. PTJ3EZIERTO 

types must appear in sets of three: the current position is the Bezier 
start point; the first two PT_BEZIERTO points are the Bezier control 
points; and the third PT_BEZIERTO point is the Bezier end point, 
which becomes the new current point. An error occurs if the 
PTJ3EZIERTO types do not appear in sets of three. An end-point 
PT_BEZIERTO can be bit-wise OR'd with PT_CLOSEFIGURE to 
indicate that the current figure is to be closed by drawing a spline 
from this end point to the start point of the most recent disjoint figure. 

PT_CLOSEFIGURE Optional flag that can be bit-wise OR'd with PTJJNETO or 

PT_BEZIERTO, as explained above. Closure updates the current 
point to the new end point. 

PTJJNETO A line is drawn from the current position to this point, which then 

becomes the new current point. PTJJNETO can be bit-wise OR'd 
with PT_CLOSEFIGURE to indicate that the current figure is to be 
closed by drawing a line segment from this point to the start point of 
the most recent disjoint figure. 

PT_MOVETO This point starts a new (disjoint) figure and becomes the new current 

point. 

PolyDraw is an alternative to consecutive calls to MoveTo, LineTo, Polyline, 
PolyBezier, and PolyBezierTo. If there is an active path invoked via BeginPath, 
PolyDraw will add to this path. 

Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: -.-.PolyDraw, TDCr.MoveTo, TDCr.LineTo, TDCr.PolyBezierTo, 
PolyBezier, TDCr.Polyline, TDC: -.BeginPath 

inline BOOL Polygon(const TPoint* points, int count); 

Draws and fills a closed polygon of count ( >= 2) line segments on this DC 
using the current pen and polygon-filling mode. The points array specifies 
the vertices of the polygon to be drawn. The polygon is automatically 
closed, if necessary, by drawing a line from the last to the first vertex. The 
current position is neither used nor altered by Polygon. Returns TRUE if the 
call is successful; otherwise returns FALSE. 

See also: TDCr.Polyline, -.-.Polygon, TDC::SetPolyFillMode, 
TDCr.GetPolyFillMode 

inline BOOL Polyline (const TPoint* points, int count); 

Draws a sequence of count ( >= 2) line segments on this DC using the 
current pen object. The points array specifies the sequence of points to be 
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PolylineTo 




PolyPolygon 



PolyPolyline 




PtVisible 



connected. The current position is neither used nor altered by Polyline. 
Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: TDC::Polygon, "Polyline, TDC: :Poly Polyline 

inline BOOL PolylineTo (const TPoint* points, int count); 

Draws one or more connected line segments on this DC using the currently 
selected pen object. The first line is drawn from the current position to the 
first of the count points in the points array. Subsequent lines, if any, connect 
the remaining points in the array, with each end point providing the start 
point of the next segment. The final end point becomes the new current 
point. No filling occurs even if a closed figure is drawn. Returns TRUE if 
the call is successful; otherwise returns FALSE. 

See also: TDC::PolyDraw, ■.■.PolylineTo, TDC::LineTo 

inline BOOL PolyPolygon (const TPoint* points, const int* PolyCounts, 

int count) ; 

Draws and fills a series of count ( >= 2), possibly overlapping, closed 
polygons on this DC using the current pen and polygon-filling mode. The 
points array specifies the vertices of the polygons to be drawn. PolyCounts is 
an array of count integers specifying the number of vertices in each 
polygon. Each polygon must be a closed polygon. The current position is 
neither used nor altered by Polygon. Returns TRUE if the call is successful; 
otherwise returns FALSE. 

See also: r.PolyPolygon, TDCr.PolyPolyline, TDC::SetPolyTillMode, 
TDCr.GetPolyFillMode 

inline BOOL PolyPolyline (const TPoint* points, const int* PolyCounts, 

int count) ; 

Draws a series of count polylines (connected line segments) on this DC 
using the currently selected pen object. The resulting figures are not filled. 
The PolyCounts array provides count integers specifying the number of 
points ( >= 2 ) in each polyline. The points array provides, consecutively, 
each of the points to be connected. Returns TRUE if the call is successful; 
otherwise returns FALSE. The current position is neither used nor altered 
by this call. 

See also: : -.PolyPolyline, TDCr.Polyline, TDC::PolyPolygon 

inline BOOL PtVisible (const TPoint& point) const; 

Returns TRUE if the given point lies within the clipping region of this DC; 
otherwise returns FALSE. 

See also: TDC::RectVisible, r.PtVisible 
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RealizePalette inline- int RealizePaletteO; 

Maps to the system palette the logical palette entries selected into this DC. 
See also: ::RealizePalette 

Rectangle inline BOOL Rectangle (int xl, int yl, int x2, int y2); 

inline BOOL Rectangle (const TPoint& pi, const TPoint& p2); 
inline BOOL Rectangle (const TPointk point, const TSize& s) ; 
inline BOOL Rectangle (const TRect& rect) ; 

Draws and fills a rectangle of the given size on this DC with the current pen 
and brush objects. The current position is neither used nor altered by this 
call. Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: TDCr.RoundRect, r.Rectangle 

RectVisible inline BOOL RectVisible (const TRect& rect) const; 

Returns TRUE if any part of the given rectangle lies within the clipping 
region of this DC; otherwise returns FALSE. 

See also: TDCr.PtVisible, "RectVisible 

ResetDC inline virtual BOOL ResetDC(DEVMODE far& devMode); 

Updates this DC using data in the given devMode structure. Returns TRUE 
if the call is successful; otherwise returns FALSE. 

See also: r.ResetDC 

RestoreBmsh ■ void RestoreBrushO; 

Restores the original GDI brush object to this DC. 
See also: r.SelectObject, TDC::OrgBrush 

RestoreDC inline virtual BOOL RestoreDC(int savedDC = -1); 

Restores the given savedDC. Returns TRUE if the context is successfully 
restored; otherwise returns FALSE. 

See also: TDC::SaveDC, r.RestoreDC 
RestoreFont virtual void RestoreFont ( ) ; 

Restores the original GDI font object to this DC. 

See also: r.SelectObject, TDCrOrgFont 
RestoreObjectS vo id RestoreOb j ects ( ) ; 

Restores all the original GDI objects to this DC. 
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RestorePalette 



RestorePen 



RestoreTextBrush 



RoundRect 




SaveDC 



ScaleViewportExt 



See also: r.SelectObject 

void RestorePalette () ; 

Restores the original GDI palette object to this DC. 

See also: r.SelectP alette, TDC::OrgPalette 

void RestorePen () ; 

Restores the original GDI pen object to this DC. 

See also: r.SelectObject, TDC::OrgPen 

void RestoreTextBrush () ; 

Restores the original GDI text brush object to this DC. 

See also: r.SelectObject 

inline BOQL RoundRect (int xl, int yl, int x2, int y2, int x3, int y3); 
inline BOOL RoundRect (const TPoint& pi, const TPoint& p2, 

const TPoint& rad) ; 
inline BOOL RoundRect (const TPoint& p, const TSize& s, const TPoint& rad); 
inline BOOL RoundRect (const TRect& rect, const TPoint& rad); 

Draws and fills a rounded rectangle of the given size on this DC with the 
current pen and brush objects. The current position is neither used nor 
altered by this call. Returns TRUE if the call is successful; otherwise returns 
FALSE. 

See also: TDCrRectangle, ::RoundRect 

inline virtual int SaveDC () const; 

Saves the current state of this DC on a context stack. The saved state can be 
restored later with RestoreDCO. Returns a value specifying the saved DC or 
if the call fails. 

See also: TDCr.RestoreDC, rSaveDC 

inline virtual BOOL ScaleViewportExt (int xNum, int xDenom, int yNurri, 

int yDenom, TSize* oldExtent = 0); 

Modifies this DCs viewport extents relative to the current values. The new 
extents are derived as follows: 

xNewVE = (xOldVE * xNum)/ xDenom 
yNewVE = (yOldVE * yNum)/ yDenom 

The previous extents are saved in oldExtent. Returns TRUE if the call is 
successful; otherwise returns FALSE. 

See also: r.ScaleViewportExt, TDCr.SetViewportExt 
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ScaleWindowExt 



ScrollDC 



SelectClipPath 




inline virtual BOOL ScaleWindowExt (int xNum, int xDenom, int yNum, 

int yDenom, TSize* oldExtent = 0); 

Modifies this DCs window extents relative to the current values. The new 
extents are derived as follows: 

xNewWE = (xOldWE * xNum)/ xDenom 
yNewWE = (yOldWE * yNum)/ yDenom 

The previous extents are saved in oldExtent. Returns TRUE if the call is 
successful; otherwise returns FALSE. 

See also: TDCr.SetWindowExt, -.-.ScaleWindowExt 

inline BOOL ScrollDC (int x, int y, const TRect& scroll, const TRect& clip, 
TRegion& updateRgn, TRect& updateRect); 

inline BOOL ScrollDC (const TPoint& delta, const TRect& scroll, 
const TRect& clip, TRegion& updateRgn, 
TRect& updateRect) ; 

Scrolls a rectangle of bits horizontally by x (or delta. x in the second version) 
device-units, and vertically by y (or delta.y) device-units on this DC. The 
scrolling and clipping rectangles are specified by scroll and clip. ScrollDC 
provides data in the updateRgn argument telling you the region (not 
necessarily rectangular) that was uncovered by the scroll. Similarly, 
ScrollDC reports in updateRect the rectangle (in client coordinates) that 
bounds the scrolling update region. This is the largest area that requires 
repainting. 

Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: ::ScrollDC, r.ScrollWindow, ::InvalidateRegion 

inline BOOL SelectClipPath (int mode) ; 

Selects the current path on this DC as a clip region, combining any existing 
clip region using the specified mode as shown in the following table: 



Mode 



Meaning 



RGN_AND The new clip region includes the overlapping areas of the current clip region 

and the current path (intersection). 

RGN_COPY The new clip region is the current path. 

RGN_DIFF The new clip region includes the areas of the current clip region with those of 

the current path excluded. 

RGN_OR The new clip region includes the combined areas of the current clip region and 

the current path (union). 
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RGN_XOR The new clip region includes the combined areas of the current clip region and 

the current path but without the overlapping areas. 

Returns TRUE if the call is successful; otherwise returns FALSE. 
See also: ::SelectClipPaih 

SelectClipRgn inline int SelectClipRgn (const TRegionk region); 

Selects the given region as the current clipping region for this DC. A copy of 
the given region is used, letting you select the same region for other DC 
objects. The return value indicates the new clipping region's type as 
follows: 



Region 



Meaning 



SelectObject 



SelectStockObject 



SetBkColor 



COMPLEXREGION Clipping Region has overlapping borders. 

ERROR Invalid DC. 

NULLREGION Clipping region is empty. 

SIMPLEREGION Clipping region has no overlapping borders. 

See also: TDCr.OffsetClipRgn, TDCr.GetClipBox, :: SelectClipRgn 

void SelectObject (const TBrushk brush); 

void SelectObject (const TPen& pen); 

virtual void SelectObject (const TFontk font); 

void SelectObject (const TPalettek palette, BOOL forceBackground = FALSE); 

Selects the given GDI object into this DC. The previously selected object is 
saved in the appropriate OrgXXX data member. For a palette argument, if 
forceBackgound is set FALSE (the default), the selected logical palette is a 
foreground palette when the window has input focus. If forceBackground is 
TRUE, the selected palette is always a background palette whether the 
window has focus or not. 

See also: r.SelectObject, v.SelectP alette, TDC::OrgXXX 
TMemoryDC:: SelectObject, 

virtual void SelectStockObject (int index); 

Selects into a DC a predefined stock pen, brush, font, or palette. 

See also: TPrintPreviewDC::SelectStockObject 

inline virtual TColor SetBkColor (TColor color); 

Sets the current background color of this DC to the given color value or the 
nearest available. Returns 0x80000000 if the call fails. 
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SetBkMode 



SetBoundsRect 



See also: TDCr.GetBkColor, ::SetBkColor 

inline int SetBkMode (int mode); 

Sets the background mode to the given mode argument, OPAQUE or 
TRANSPARENT. Returns the previous background mode. 

See also: TDC::GetBkMode, r.SetBkMode 

inline UINT SetBoundsRect (TRect& bounds, UINT flags); 

Controls the accumulation of bounding-rectangle information for this DC. 
Depending on the value of flags, the given bounds rectangle (possibly 
NULL) can combine with or replace the existing accumulated rectangle. 
flags can be any appropriate combination of the following values: 



Constant 



Meaning 



SetBrushOrg 



SetDIBits 



DCB_ACCUMULATE 

DCB_DISABLE 

DCB_ENABLE 

DCB_RESET 
DCB SET 



Add bounds (rectangular union) to the current accumulated rectangle. 

Turn off bounds accumulation. 

Turn on bounds accumulation (the default setting for bounds 
accumulation is disabled). 

Set the bounding rectangle empty. 

Set the bounding rectangle to bounds. 

There are two bounding-rectangle accumulations, one for Windows and 
one for the application. The Windows-accumulated bounds can be queried 
by an application but not altered. The application can both query and alter 
the DCs accumulated bounds. 

See also: TDC::GetBoundsRect, :: SetBoundsRect 

inline BOOL SetBrushOrg (const TPoint& origin, TPoint* oldOrg = 0); 

Sets the origin of the currently selected brush of this DC with the given 
origin value. The previous origin is passed to oldOrg. Returns TRUE if 
successful; otherwise returns FALSE. 

See also: TDC::GetBrushOrg 

inline BOOL SetDIBits (TBitmap& bitmap, WORD startScan, WORD numScans, 

■ const void HUGE* bits, const BITMAPINFO far& Info, 
WORD usage) ; 
inline BOOL SetDIBits (TBitmapk Bitmap, const TDib& dib) ; 

The first version sets the pixels in bitmap (the given destination bitmap on 
this DC), from the source DIB (device-independent bitmap) color data 
found in the byte array bits and the BITMAPINFO structure, Info. numScan 
scanlines are taken from the DIB, starting at scanline startScan. The usage 
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argument specifies how the bmiColors member of BITMAPINFO is 
interpreted, as explained in TDC::GetDIBits(). 

In the second version of SetDIBits, the pixels are set in bitmap from the 
given source TDib argument. 

SetDIBits returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: TDC::GetDIBits, TDC:: SetDIBitsToDevice, ::SetDIBits 

SetDIBitsToDeVl'ce inline BOOL SetDIBitsToDevice (const TRect& dst, const TPoint& src, 

WORD startScan, WORD numScans, 
const void HUGE* bits, 

const BITMAPINFO far& bitslnfo, WORD usage) ; 
inline BOOL SetDIBitsToDevice (const TRect& dst, const TPoint& src, 

const TDib& dib) ; 

The first version sets the pixels in dst (the given destination rectangle on 
this DC) from the source DIB (device-independent bitmap) color data 
found in the byte array bits and the BITMAPINFO structure, bitslnfo. The 
DIB origin is specified by the point src. numScan scanlines are taken from 
the DIB, starting at scanline startScan. The usage argument determines how 
the bmiColors member of BITMAPINFO is interpreted, as explained in 
TDC::GetDIBits(). 

In the second version of SetDIBitsToDevice, the pixels are set in dst from dib, 
the given source TDib argument. 

SetDIBits returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: TDCr.GetDIBits, -.-.SetDIBitsToDevice, TDib 

SetMapMode inline virtual int SetMapMode ( int mode); 

Sets the current window mapping mode of this DC to mode. Returns the 
previous mapping mode value. The mapping mode defines how logical 
coordinates are mapped to device coordinates. It also controls the 
orientation of the device's x- and y-axes. See TDCr.GetMapMode for a 
complete list of mapping modes. 

See also: TDCr.GetMapMode, -.-.SetMapMode 

SetMapperFlagS inline DWORD SetMapperFlags(DWORD flag); 

Alters the algorithm used by the font mapper when mapping logical fonts 
to physical fonts on this DC. If successful, the function sets the current 
font-mapping flag to flag and returns the previous mapping flag; otherwise 
GDI_ERROR is returned. The mapping flag determines whether the font 
mapper will attempt to match a font's aspect ratio to this DCs aspect ratio. 
If bit oiflag is set to 1, the mapper selects only matching fonts. If no 
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SetMiterLimit 




SetPixel 



SetPolyFillMode 



SetROP2 



matching fonts exist, a new aspect ratio is chosen and a font is retrieved to 
match this ratio. 

See also: ::SetMapperFlags 

inline BOOL SetMiterLimit (float newLimit, float* oldLimit = 0); 

Sets the limit of miter joins to newLimit and puts the previous value in 
oldLimit. Returns TRUE if successful; otherwise returns FALSE. 

See also: :: SetMiterLimit 

inline TColor SetPixel (int x, int y, TColor color); 
inline TColor SetPixel (const TPoint& p, TColor color); 

Sets the color of the pixel at the given location to the given color and 
returns the pixel's previous color. 

See also: TDC::GetPixel, -.-.SetPixel 

inline int SetPolyFillMode (int mode); 

Sets the polygon-filling mode for this DC to the given mode value, either 
ALTERNATE or WINDING. Returns the previous fill mode. 

See also: TDC::GetPolyFillMode, -SetPolyFillMode, TDCr.Polygon 

inline int SetR0P2 (int mode); 

Sets the current foreground mix mode mode of this DC to the given mode 
value and returns the previous mode. The mode argument determines how 
the brush, pen, and existing screen image combine when filling and 
drawing, mode can be one of the following values: 



Value 



Meaning 



R2_BLACK 

R2_COPYPEN 

R2_MASKNOTPEN 

R2_MASKPEN 

R2_MASKPENNOT 

R2_MERGEPEN 
R2_MERGENOTPEN 

R2_MERGEPENNOT 

R2_NOP 
R2_NOT 
R2 NOTCOPYPEN 



Pixel is always binary 0. 

Pixel is the pen color. 

Pixel is a combination of the colors common to both the display and 

the inverse of the pen. 

Pixel is a combination of the colors common to both the pen and the 

display. 

Pixel is a combination of the colors common to both the pen and the 

inverse of the display. 

Pixel is a combination of the pen color and the display color. 

Pixel is a combination of the display color and the inverse of the pen 

color. 

Pixel is a combination of the pen color and the inverse of the display 

color. 

Pixel remains unchanged. 

Pixel is the inverse of the display color. 

Pixel is the inverse of the pen color. 
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Value Meaning 

R2_N0TMASKPEN Pixel is the inverse of the R2_MASKPEN color. 

R2_NOTMERGEPEN Pixel is the inverse of the R2_MERGEPEN color. 

R2_NOTXORPEN Pixel is the inverse of the R2_XORPEN color. 

R2_WHITE Pixel is always binary 1 . 

R2_XORPEN Pixel is a combination of the colors in the pen and in the display, but 

not in both. 

See also: TDC::GetROP2, ::SetROP2, TDCr.GetDeviceCaps 

SetStretChBltMode inline int SetStretchBltMode(int mode); 

Sets the stretching mode of this DC to the given mode value and returns the 
previous mode. The mode argument defines which scan lines and /or 
columns are eliminated by TDCr.StretchBltQ: BLACKONWHITE, 
COLORONCOLOR, or WHITEONBLACK. 

See also: TDC::GetStretchBHMode, ::SetStretchBHMode, TDC::StretchBlt 

SetSystemPaletteUse inline int SetSystemPaletteUse(int usage); 

Changes the usage of this DCs system palette. The usage argument can be 
SYSPAL_NOSTATIC or SYSPAL_STATIC. Returns the previous usage 
value. 

See also: TDCr.GetSystemPaletteUse, ::SetSystemPaletteUse 

SetTextAlign inline UINT SetTextAlign(UINT flags); 

Sets the text-alignment flags for this DC. If successful, SetTextAlign returns 
the previous text-alignment flags; otherwise, it returns GDIJERROR. The 
flag values are as listed for the TDC::GetText Align function. The text- 
alignment flags determine how TDC::TextOut() and TDC::ExtTextOut align 
text strings in relation to the first character's screen position. 

See also: TDCr.GetText Align, ::SetText Align, TDC::TextOut, 
TDC::ExtTextOut 

GetTextCharacterExtra inline int GetTextCharacterExtra ( ) const; 

If successful, returns the current intercharacter spacing, in logical units, for 
this DC; otherwise returns INVALID_WIDTH. 

See also: TDC::SetTextCharacterExtra, "GetTextCharacterExtra 

SetTextCharacterExtra inline int SetTextCharacterExtra(int extra); 

If successful, sets the current intercharacter spacing to extra, in logical units, 
for this DC, and returns the previous intercharacter spacing. Otherwise, 
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returns 0. If the current mapping mode is not MM_TEXT, the extra value is 
transformed and rounded to the nearest pixel. 

See also: TDC::GetTextCharacterExtra, ::SetTextCharacterExtra 

SetTextColor inline virtual TColor SetTextColor(TColor color); 

Sets the current text color of this DC to the given color value. The text color 
determines the color displayed by TDC::TextOut() and TDC::ExtTextOut(). 

See also: TDCr.GetTextColor, :: SetTextColor 

SetTextJustification inline BOOL SetTextJustification(int breakExtra, int breakCount); 

Sets breakExtra logical units as the total extra space to be added to 
breakCount break characters when text strings are displayed using 
TDC::TextOut() and TDC::ExtTextOut(). The extra space is distributed 
evenly between the break characters. The break character is usually the 
ASCII 32 space, but some fonts define other characters. 
TDC::GetTextMetrks() can be used to retrieve the value of the break 
character. TDC::GetTextExtentPoint() must be called to obtain text width 
before justification. From this, the breakExtra value can be computed for the 
SetTextJustification call. 

If the current mapping mode is not MMJTEXT, the extra value is 
transformed and rounded to the nearest pixel. 

SetTextJustification returns TRUE if the call is successful; otherwise, it 
returns FALSE. 

See also: '/.SetTextJustification, TDCr.GetTextExtentPoint 

SetViewportExt inline virtual BOOL SetViewportExt (const TSize& extent, TSize* oldExtent 



SetViewportOrg 



Sets this DCs viewport x- and y-extents to the given extent values. The 
previous extents are saved in oldExtent. Returns TRUE if the call is 
successful; otherwise, returns FALSE. The extent value determines the 
amount of stretching or compression needed in the logical coordinate 
system to fit the device coordinate system, extent also determines the 
relative orientation of the two coordinate systems. 

See also: TDC::GetViewportExt, :: SetViewportExt 

inline virtual BOOL SetViewportOrg (const TPoint& origin, TPoint* oldOrg 



Sets this DCs viewport origin to the given origin value, and saves the 
previous origin in oldOrg. Returns TRUE if the call is successful; otherwise 
returns FALSE. 
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See also: TDC::GetViewportOrg, TDCr.OffsetViewportOrg, r.SetViewportOrg 

SetWindowExt inline virtual BOOL" SetWindowExt ( const TSize& extent, TSize* oldExtent 

= 0); 

Sets this DCs window x- and y-extents to the given extent values. The 
previous extents are saved in oldExtent. Returns TRUE if the call is 
successful; otherwise, returns FALSE. The extent value determines the 
amount of stretching or compression needed in the logical coordinate 
system to fit the device coordinate system, extent also determines the 
relative orientation of the two coordinate systems. 

See also: TDCr.GetWindowExt, :: SetWindowExt, TDC::ScaleWindowExt 

SetWindOwOrg inline BOOL SetWindowOrg ( const TPoint& origin, TPoint* oldOrg = 0); 

Sets the origin of the window associated with this DC to the given origin 
value, and saves the previous origin in oldOrg. Returns TRUE if the call is 
successful; otherwise, returns FALSE. 

See also: TDCr.GetWindowOrg, TDCr.OffsetWindowOrg, :: SetWindowOrg 

SetWorldTransform inline BOOL SetWorldTransform(XFORM far& xf orm) ; 

Sets a two-dimensional linear transformation, given by the xform structure, 
between world space and page space for this DC. Returns TRUE if the call 
is successful; otherwise, returns FALSE. 




StretchBIt 



See also: TDC: Modify WorldTransf orm, :: SetWorldTransform, XFORM 

inline BOOL StretchBIt (int dstX, int dstY, int dstW, int dstH, 

const TDC& srcDC, int srcX, int srcY, int srcW, 
int srcH, DWORD rop) ; 

inline BOOL StretchBIt (const TRect& dst, const TDC& srcDC, 
const TRect& src, DWORD rop); 

Copies a bitmap from the source DC to a destination rectangle on this DC 
specified either by upper left-corner coordinates (dstX, dstY), width dstW, 
and height dstH, or (in the second version) by a TRect object, dst. The source 
bitmap is similarly specified with (srcX, srcY), srcW, and srcH, or by a TRect 
object, src. StretchBIt stretches or compresses the source according to the 
stretching mode currently set in this DC (the destination DC). The raster- 
operation code, rop, specifies how the colors are combined in output 
operations that involve a brush, a source bitmap, and a destination bitmap. 
The rop codes are described in the entry for TDC::MaskBlt. 

See also: -.-.StretchBIt, TDCr.MaskBlt, TDC::SetStretchBltMode 
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StretchDIBitS inline BOOL StretchDIBits (const TRect& dst, const TRect& src, 

const void HUGE* bits, 

const BITMAPINFO far& bitslnfo, WORD usage, 
DWORD rop) ; 
inline BOOL StretchDIBits (const TRect& dst, const TRectfc src, 

const TDib& dib, DWORD rop); 

Copies the color data from src, the source rectangle of pixels in the given 
DIB (device-independent bitmap) on this DC, to dst, the destination 
rectangle. The DIB bits and color data are specified in either the byte array 
bits and the BITMAPINFO structure bitslnfo or in the TDib object, dib. The 
rows and columns of color data are stretched or compressed to match the 
size of the destination rectangle. The usage argument specifies how the 
bmiColors member of BITMAPINFO is interpreted, as explained in 
TDC::GetDIBits(). The raster operation code, rop, specifies how the source 
pixels, the current brush for this DC, and the destination pixels are 
combined to produce the new image. See TDCr.MaskBlt for a detailed list of 
rop codes. 

See also: -StretchDIBits, TDC::MaskBlt, TDib 

StrokeAndFillPath inline BOOL StrokeAndFillPathO ; 

Closes any open figures in the current path of this DC, strokes the outline 
of the path using the current pen, and fills its interior using the current 
brush and polygon fill mode. Returns TRUE if the call is successful; 
otherwise returns FALSE. 

See also: TDCr.StrokePath, ::StrokeAndFillPath, TDC::BeginPath, 
TDCr.FillPath, TDCr.EndPath, TDCr.SetPolyFillMode, 




StrokePath 



TabbedTextOut 




inline BOOL StrokePath () ; 

Renders the current, closed path on this DC, using the DCs current pen. 

See also: •.■.StrokePath, TDCr.StrokeAndFillPath, TDC::BeginPath 

inline virtual BOOL TabbedTextOut (const TPoint& p, const char far* string, 

int count, int numPositions, 
const int* positions, int tabOrigin); 
inline BOOL TabbedTextOut (const TPointk p, const char far* string, 

int count, int numPositions, 
const int* positions, int tabOrigin, 
TSize& size) ; 

Draws up to count characters of the given null-terminated string in the 
current font on this DC. If count is -1, the whole string is written. 
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TextOut 



TextRect 



Tabs are expanded according to the given arguments. The positions array 
specifies numPositions tab stops given in device units. The tab stops must 
have strictly increasing values in the array. If numPositions and positions are 
both 0, tabs are expanded to eight times the average character width. If 
numPositions is 1, all tab stops are taken to be positionslO] apart. tabOrigin 
specifies the x-coordinate in logical units from which tab expansion will 
start. 

The p argument specifies the logical coordinates of the reference point that 
is used to align the first character depending on the current text-alignment 
mode. This mode can be inspected with TDCr.GetText Align and changed 
with TDCr.SetTextAlign. By default, the current position is neither used nor 
altered by TabbedTextOut. However, if the align mode is set to 
TA_UPDATECP, TabbedTextOut ignores the reference point argument(s) 
and uses/ updates the current position as the reference point. 

The size argument in the second version of TabbedTextOut reports the 
dimensions (size.y = height and size.y = width) of the string in logical units. 

TabbedTextOut returns TRUE if the call is successful; otherwise, it returns 
FALSE. 

See also: TDCr.TextOut, ::TabbedTextOut 

inline virtual BOOL TextOut (int x, int y, const char far* string, 

int count = -1) ; 
inline BOOL TextOut (const TPoint& p, const char far* string, int count 
= -1); 

Draws up to count characters of the given null-terminated string in the 
current font on this DC. If count is -1 (the default), the entire string is 
written. 

The (x, y) or p arguments specify the logical coordinates of the reference 
point that is used to align the first character, depending on the current text- 
alignment mode. This mode can be inspected with TDC::GetText Align and 
changed with TDCr.SetTextAlign. By default, the current position is neither 
used nor altered by TextOut. However, the align mode can be set to 
TAJJPDATECP, which makes Windows use and update the current 
position. In this mode, TextOut ignores the reference point argument(s). 

TextOut returns TRUE if the call is successful; otherwise, it returns FALSE. 

See also: TDC::ExtTextOut, ::TextOut, TDCr.GetTextAlign 

inline BOOL TextRect (int xl, int yl, int x2, int y2) ; 

inline BOOL TextRect (const TRect& rect); 

inline BOOL TextRect(int xl, int yl, int x2, int y2, TColor color); 

inline BOOL TextRect (const TRect rect, TColor color); 
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UpdateColors 



WidenPath 




Fills the given rectangle by calling r.ExtTextOut with an ETO_OPAQUE 
rectangle type argument and a NULL string. If no color argument is 
supplied, the current backgound color is used. If a color argument is 
supplied, that color is set to the current background color which is then 
used for filling. TextRect returns TRUE if the call is successful; otherwise, 
returns FALSE. 

See also: r.ExtTextOut, TDC::SetBkColor, ETOjDPAQUE, 

inline void UpdateColors () ; 

Updates the client area of this DC by matching the current colors in the 
client area to the system palette on a pixel-by-pixel basis. 

See also: : -.UpdateColors 

inline BOOL WidenPath () ; 

Redefines the current, closed path on this DC as the area that would be 
painted if the path were stroked with this DCs current pen. The current 
pen must have been created under the following conditions: 

If ::CreatePen or the TPen::TPen(int Style, int Width, TColor Color) or 
TPen::TPen(const LOGPEN* LogPen) constructors were used, the width of 
the pen in device units must be greater than 1. 

If ::ExtCreatePen or the TPen::TPen(DWORD PenStyle, DWORD Width, const 
TBrush& Brush, DWORD StyleCount, LPDWORD pSTyle) or 
TPen::TPen(DWORD PenStyle, DWORD Width, const LOGBRUSH& logBrush, 
DWORD StyleCount, LPDWORD pSTyle) constructors were used, the pen 
must be a geometric pen. 

Any Bezier curves in the path are converted to sequences of linear 
segments approximating the widened curves, so no Bezier curves remain in 
the path after a WidenPath call. 

WidenPath returns TRUE if the call is successful; otherwise, it returns 
FALSE. 

See also: :: WidenPath, TDC::FlattenPath,TDC::BeginPath 

Protected data members 



Handle 



OrgBrush 



HDC Handle; 

The Windows handle of this DC. 

See also: TDC constructors 

HBRUSH OrgBrush; 
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OrgFont 



OrgPalette 



OrgPen 



OrgTextBrush 




ShouldDelete 



Handle to the original GDI brush object for this DC. Holds the previous 
brush object whenever a new brush is selected with SelectObject(brush). 

See also: TDC::SelectObject, ::SelectObject 

HFONT OrgFont; 

Handle to the original GDI font object for this DC. Holds the previous font 
object whenever a new font is selected with SelectObject(font). 

See also: TDC::SelectObject, ::SelectObject 

HPALETTE OrgPalette; 

Handle to the original GDI palette object for this DC. Holds the previous 
palette object whenever a new palette is selected with SelectObject(palette). 

See also: TDCr.SelectObject, r.SelectP alette 

HPEN OrgPen; 

Handle to the original GDI pen object for this DC. Holds the previous pen 
object whenever a new pen is selected with SelectObject(pen). 

See also: TDCr.SelectObject, r.SelectObject 

HBRUSH OrgTextBrush; 

The handle to the original GDI text brush object for this DC. Stores the 
previous text brush handle whenever a new brush is selected with 
SelectObject(textJbrush). 

See also: TDCr.SelectObject, r.SelectObject 

BOOL ShouldDelete; 

Set to TRUE if Handle for this object should be deleted by the destructor; 
otherwise set to FALSE. 

See also: enum TDCr.TAutoDelete, -TDC 

Protected constructors 



Constructor tdc ( ) ; 

For use by derived classes only. Calls Init to clear the OrgXXX data 
members and sets ShouldDelete to TRUE. 

See also: TDCrlnit 
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Protected member functions 



GetAttributeHDC . virtual HDC GetAttributeHDCO const; 

Returns the attributes of the DC object. 

See also: TPrintPreview::GetAttributeHDC 
GetHDC inline HDC GetHDCO const; 

Returns a handle to the DC. 

' nj t void Init(); 

Sets OrgBrush, OrgPen, OrgFont, OrgBitmap, and OrgPalette to 0, and sets 
ShouldDelete to TRUE. This function is for internal use by the TDC 
constructors. 

See also: TDC constructors, SelectObject 

TDecoratedFrame class decframe.h 

TDecoratedFrame automatically positions its client window (you must 
supply a client window) so that it is the same size as the client rectangle. 
You can add additional decorations like toolbars and status lines to a 
window. TDecoratedFrame is a streamable class. For more information about 
decorated frame windows, see Chapter 6 in the ObjectWindows Programmer's 
Guide. 

Public constructors 

Constructor TDecoratedFrame (TWindow* parent, const char far *title, TWindow* 

clientWnd, BOOL trackMenuSelection = FALSE, TModule* 
module - 0) ; 

Constructs a TDecoratedFrame object with the specified parent window 
(parent), window caption (title), and module ID. Sets Attr. Title to the new 
title. Passes a pointer to the client window if one is specified. By default set 
to FALSE, trackMenuSelection controls whether hint text appears at the 
bottom of the window when a menu item is highlighted. 

Public member functions 

Insert void Insert (TWindowk decoration, TLocation = Top) ; 
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PreProcessMsg 



After you specify where the decoration should be placed, Insert adds it just 
above, below, left, or right of the client window. This process is especially 
important when there are multiple decorations. Insert looks at the 
decoration's Attr. Style member and checks the WS_VISIBLE flag to tell 
whether the decoration should initially be visible or hidden. To position the 
decoration, Insert uses TLocation enum, which describes Top, Left, Bottom, 
and Right positions where the decoration can be placed. 

BOOL PreProcessMsg (MSG& msg) ; 

Overrides the virtual function defined in TFrameWindow to give decorations 
an opportunity to perform mnemonic access preprocessing. 

See also: TFrameWindow: -.PreProcessMsg, T Window: -.PreProcessMsg 



Menultemld 



Protected data members 



UINT MenuItemID; 
Specifies the menu item ID. 
TrackMenuSelection B ool TrackMenuSelection; 



Specifies whether you want menu selection and help status information 
visible. 



Protected member functions 



EvCommand 



EvCommandEnable 



EvEnterldle 



EvMenuSelect 



LRESULT EvCommand (UINT Id, HWND hWndCtl, UINT notifyCode); 
Automates hiding and showing of decorations. 

void EvCommandEnable (TCommandEnabler& ce) ; 

Handles checking and unchecking of menu items that are associated with 
decorations. 

See also: TMenuItemEnablerr.TCommandEnabler 

void EvEnterldle (UINT source, HWND hWndDlg) ; 

Responds to a Windows API WM_ENTERIDLE message that tells an 
application's main window that a dialog box or a menu is entering an idle 
state. EvEnterldle also handles updating the status bar with the appropriate 
help message. 

See also: ::WM_ENTERIDLE 

void EvMenuSelect (UINT Menultemld, UINT flags, HMENU hMenu) ; 
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Responds to user menu selection. If Menultemld is blank, displays an empty- 
help message; otherwise, it displays a help message with the specified 
string ID. See EvEnterldle for a description of how the help message is 
loaded. 

EvSize inline void EvSize(UINT sizeType, TSize& size); 

Passes a WM_SIZE message to TLayout Window. 

See also: T Window: :EvSize 
SetupWindow void SetupwindowO; 

Calls Layout to size and position the decoration. 

See also: TFrameWindowr.SetUpWindow, TWindowr.SetUpWindow 



Response table entries 






Response table entry 


Member function 


EV_WM ENTERIDLE 
EV_WM_MENUSELECT 
EV_WM SIZE 


EvEnterldle 

EvMenuSelect 

EvSize 



TDecoratedMDIFrame class 



decmdifr.h 



TDecoratedMDIFrame is an MDI frame that supports decorated child 
windows. TDecoratedMDIFrame is a streamable class. 



Public constructors 

Constructor TDecoratedMDIFrame (const char far *title, TResId menuResId, 

TMDIClient &clientWnd = *new TMDIClient, 
BOOL trackMenuSelection = FALSE, TModule* module = 0); 

Constructs a decorated MDI frame of the specified client window with the 
indicated menu resource ID. By default, menu hint text is not displayed. 

Protected member function 



DefWindowProc 



LRESULT DefWindowProc (UINT message, WPARAM wParam, LPARAM lParam) ; 
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Overrides T Window :DefWindowProc and calls the Windows API function 
r.DefFrameProc that provides default processing for any incoming message 
the MDI child window does not process. 

See also: ::DefFrameProc, ::DefWindowProc, TMDIFrame::DefWindowProc 



Response table entries 



The TDecoratedMDIFrame response table has no entries. 



TDesktopDC class 



dch 



A DC class derived from TWindowDC, TDesktopDC provides access to the 
desktop window's client area, which is the screen behind all other 
windows. 

Public constructors 

Constructor TDesktopDC ( ) ; 

Default constructor for TDesktopDC objects. 



TDialog class 



dialog.h 



See Chapter 4 in the 

ObjectWindows 

Programmers Guide 

for a description of 

interface objects. See 

Chapter 8 in the 

ObjectWindows 

Programmer's Guide 

for specific 

instructions about 

creating dialog boxes. 



TDialog objects represent both modal and modeless dialog box interface 
elements. (A modal dialog box disables operations in its parent window 
while it is open.) A TDialog object has a corresponding resource definition 
that describes the placement and appearance of its controls. The identifier 
of this resource definition is supplied to the constructor of the TDialog 
object. A TDialog object is associated with a modal or modeless interface 
element by calling its Execute or Create member function, respectively. 
TDialog is a streamable class. 

ObjectWindows provides three-dimensional (3-D) support for dialog boxes. 
If your application expects to use Microsoft's CTL3D DLL, you need to 
register your application by calling TApplication::EnableCtl3d. 
ObjectWindows will then automatically forward the WM_CTLCOLOR 
message to the CTL3D DLL. 

ObjectWindows also provides BWCC support for dialog boxes. Unless a 
custom template is specified, TDialog uses the BWCC templates. (By 
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default, T 'Application's member function EnableBWCC enables BWCC 
support.) 

Public data members 



Attr 



IsModal 



TDialogAttr Attr; 

Attr holds the dialog creation attributes of the dialog box. TDialogAttr is 
defined on page 156. 

BOOL IsModal; 

IsModal is TRUE if the dialog box is modal and FALSE if it is modeless. 



Public constructors and destructor 



Constructor 



Destructor 



TDialog (TWindow* parent, TResId resld, TModule* module = 0); 

Invokes a TWindow constructor, passing parent and module, and calls 
DisableAutoCreate so that the TDialog will not be automatically created and 
displayed along with its parent. TDialog then initializes Title to -1 and sets 
Attr.Name using the dialog's integer or string resource identifier, which 
must correspond to a dialog resource definition in the resource file. Finally, 
it initializes Attr. Par am to and sets IsModal to FALSE. 

See also: Tapplication::EnableBWCC, TWindow: -.TWindow, 
TWindow -.-.DisableAutoCreate 

-TDialogO; 

If Attr.Name is a string and not an integer resource identifier, this destructor 
frees memory allocated to hold the name of the TDialog {Attr.Name). 

See also TWindow::~TWindow 



Public member functions 



CloseWindow 



CmCancel 



void CloseWindow (int retValue = IDCANCEL); 

Conditionally shuts down the dialog box. If the dialog box is modeless, it 
calls TWindow: -.CloseWindow. If the dialog box is modal, it calls CanClose. If 
CanClose returns TRUE, CloseWindow calls TransferData to transfer dialog 
box data, passing it retValue. The default value of retValue is IDCANCEL. 

See also: TWindow -.-.CloseWindow 

void CmCancel ( ) ; 



140 



ObjectWindows 2.0 Reference Guide 



TDialog class 



CmOk 



Create 



Destroy 



DialogFunction 



DoCreate 



Do Execute 



Automatic response to a click on the Cancel button of the dialog box. Calls 
Close'Window, passing IDCANCEL. 

See also TDialog: :CloseWindow 

void CmOk ( ) ; 

Responds to a click on the dialog box's OK button (with the identifier 
IDOK). Calls CloseWindow, passing IDOK. 

See also: TDialogr.CloseWindow 

virtual BOOL Create ( ) ; 

Creates a modeless dialog box interface element associated with the TDialog 
object. Calls DisableAutoCreate to prevent automatic creation of all child 
windows. Calls EnableKBHandler to enable keyboard handling. Registers all 
the dialog's child windows for custom control support. Calls the Windows 
function CreateDialogParam to create the dialog box. 

Create returns TRUE if successful. If unsuccessful, Create throws a 
TXInvalidWindow exception. 

See also: TDialogr.Execute, TModule::MakeWindow, 
T 'Window: -.DisableAutoCreate 

virtual void Destroy(int retValue - IDCANCEL); 

Destroys the interface element associated with the TDialog object. If the 
element is a modeless dialog box, Destroy calls TWindowr.Destroy. If the 
element is a modal dialog box, Destroy calls EnableAutoCreate on all child 
windows. Then Destroy calls the Windows function EndDialog, passing 
retValue as the value returned to indicate the result of the dialog's 
execution. The default retValue is IDCANCEL. 

See also: TWindowr.Destroy, TWindow: -.EnableAutoCreate 

virtual BOOL DialogFunction (UINT message, WPARAM, LPARAM) ; 

To process messages within the dialog function, your application must 
override this function. DialogFunction returns TRUE if the message is 
handled and FALSE if the message is not handled. 

virtual HWND DoCreate ( ) 

Create calls DoCreate to perform the actual creation of a dialog box. DoCreate 
calls the Windows API function CreateDialogParam to perform the actual 
creation of the dialog box. 

virtual int DoExecute ( ) ; 



Chapter 1, Library reference 



141 



TDialog class 



EvClose 



EvInitDialog 



EvPaint 



EvSetFont 



Execute 



GetDefaultld 



GetltemHandle 



PreProcessMsg 



Execute calls DoExecute, which calls the Windows API function 
DialogBoxParam to perform the actual execution of a dialog box. 

void EvClose ( ) ; 

Responds to an incoming EvClose message by shutting down the window. 

virtual BOOL EvInitDialog (HWND hWndFocus); 

EvInitDialog is automatically called just before the dialog box is displayed. 
It calls SetupWindow to perform any setup required for the dialog box or its 
controls. 

See also: T Window:: SetupWindow 

void EvPaint ( ) ; 

If the control has a predefined Windows class, EvPaint calls DefWndProc for 
Windows-supplied painting. Otherwise, it calls TWindowr.EvPaint. 

See also: TWindowr.EvPaint 

virtual void EvSetFont (HFONT) ; 

Responds to a request to change a dialog's font. 

virtual int ExecuteO; 

Execute creates and executes a modal dialog box interface element 
associated with the TDialog object. If the element is successfully associated, 
Execute does not return until the TDialog is closed. 

Execute then calls DisableAutoCreate to prevent all child windows from 
being created automatically. After it calls EnableKBHandler to enable 
keyboard handling, DialogBoxParam registers all the dialog's child windows 
for custom control support. Finally, Execute calls DoExecute, which calls the 
Windows API function DialogBoxParam to execute the dialog box. If errors 
occur, a TXInvalidWindow exception is thrown. 

See also: TModule::ExecDialog, TWindow::DisableAutoCreate 

UINT GetDefaultld () const; 
Gets the default resource ID. 

HWND GetltemHandle (int childld) ; 

Returns the dialog box control's window handle identified by the supplied 
ID. Because GetltemHandle is now obsolete, new applications should use 
TWindowr.GetDlgltem. 

BOOL PreProcessMsg (MSG &); 
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Performs preprocessing of window messages. If the child window has 
requested keyboard navigation, PreProcessMsg handles any accelerator key 
messages and then calls the Windows API function r.IsDialogMessage to 
process any other keyboard messages. 

See also: T Window: :PreProcessMsg 

SendDlgltemMsg DWORD SendDlgItemMsg(int Childld, WORD Msg, WORD WParam, DWORD LParam); 

Sends a Windows control message, identified by Msg, to the dialog box's 
control identified by its supplied ID, ChildlD. WParam and LParam become 
parameters in the control message. SendDlgltemMsg returns the value 
returned by the control, or if the control ID is invalid. 

SetCaption void SetCaption (const char far* title); 

If Title is not -1, calls TWindow:: SetCaption. 

See also: SetupWindow, TWindow: -.SetCaption 
SetDefaultld void SetDefaultId(UINT Id); 

Sets the default resource ID. 

Protected member functions 



EvCtlColor 



GetClassName 



HBRUSH EvCtlColor (HDC, HWND hWndChild, UINT ctlType) ; 

Passes the handle to the display context for the child window, the handle to 
the child window, and the default system colors to the parent window. The 
parent window then uses the display-context handle given in HDC to set 
the text and background colors of the child window. 

If three-dimensional (3-D) support is enabled, EvCtlColor handles the 
EV_WM_CTLCOLOR message by allowing the CTL3D DLL to process the 
WM_CTLCOLOR message in order to set the background color and 
provide a background brush for the window. 

See also: TApplication::EnableCtl3d 

char far* GetClassName ( ) ; 

GetClassName overrides the virtual function defined in TWindow and 
returns the name of the dialog box's default Windows class, which must be 
used for a modal dialog box. For a modeless dialog box, GetClassName 
returns the name of the default TWindow. If BWCC is enabled, 
GetClassName returns BORDLGCLASS. 

See also: TWindow::GetClassName 
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GetWihdowClasS void GetWindowClass (WNDCLASS& wndClass); 

Overrides the virtual function defined in TWindow. Fills WndClass with a 
TDialog registration attributes obtained from an existing TDialog window or 
BWCC if enabled. By default, a TDialog object has a standard application 
icon and arrow cursor. To change these or other registration attributes, 
redefine this member function and GetClassName in your TDialog derived 
class. Be sure to call GetWindowClass in your GetWindowClass member 
function prior to modifying the defaults that TDialog sets. 

See also: TWindow ::GetWindowClass 

SetupWindOW void SetupWindow () ; 

Overrides the virtual function defined in TWindow. Sets up the dialog box 
by calling SetCaption (sets Title) and TWindowr.SetupWindow. 

If three-dimensional (3-D) support is enabled, SetupWindow calls the CTL3D 
DLL to create the dialog box. 

See also: TCommonDialog:: SetupWindow, TDialog:: SetCaption, 
TWindow:: SetupWindow 



Response table entries 



Response table entry 


Member function 


EV COMMAND (IDCANCEL, CmCancel) 


CmCancel 


EV COMMAND (IDOK, CmOk) 


CmOk 


EV CTLCOLOR 


EvCtlColor 


EV WM CLOSE 


EvClose 


EV WM PAINT 


EvPaint 



TDialogAttr struct 



dialog.h 



A TDialogAttr is used to hold a TDialog's creation attributes. 



Public data members 



Name 



Param 



char far* Name; 

Name holds the identifier of the dialog resource. 

DWORD Param; 
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Param holds a parameter that is supplied to the dialog box when it is 
created. After Windows accepts Param, it is then available in the message 
response functions associated with WM_INITDIALOG. 

See also: TDialogr.Attr 

TDib class gdiobjec.h 

The class TDib, derived from TGdiObject, represents GDI Device 
Independent Bitmap (DIB) objects. TDibDCs encapsulate the creation of 
DCs using DIB.DRV (a GDI driver provided with Windows MME and 3.1). 
DIBs have no Windows handle; they are just structures containing format 
and palette information and a collection of bits or pixels. TDib provides a 
convenient way to work with DIBs like any other GDI object. The memory 
for the DIB is in one Global Alloc' & unit so it can be passed to the Clipboard, 
OLE, and so on. 

The TDib destructor overloads the base destructor because DIBs are not real 
GDI objects. 

Protected data members 

BitS void HUGE* Bits; 

Bits points into the block of memory pointed to by Info. 

See also: TDibr.GetBits 
H int H; 

The height of this DIB in pixels. 

See also: TDibr.Height, TDib::Size, TDibr.NumScans 
'if© BITMAPINFO far* Info; 

Locked global allocated block. 

See also: TDib::GetInfo 
IsCore BOOL' I sCore ; 

Set TRUE if this DIB is an old-style PM DIB using core headers; otherwise, 
set FALSE. 

See also: TDib::isPM 

Mode WORD Mode; 
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NumCIrs 



W 



If Mode is DIB_RGB_Colors, the color table contains 4-byte RGB entries. If 
Mode is DIBJPALjCOLORS, the color table contains 2-byte indexes into 
some other palette (such as the system palette). Because either of these two 
cases might exist, two versions of certain functions (such as GetColorsO and 
GetlndicesO) are required. 

See also: TDib::GetColors, TDib::GetIndices, TDib::Usage 

long NumCIrs; 

The number of colors associated with this DIB. 

See also: TDibr.NumColors 

int W; 

The width of this DIB in pixels. 

See also: TDibr.Width, TDibr.Size 



Public constructors and destructor 



Constructor TDib (HGLOBAL handle, TAutoDelete autoDelete = NoAutoDelete); 

Creates a TDib object and sets the Handle data member to the given 
borrowed handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle will not be deleted when the C++ object 
is destroyed. 

See also: TGdiObject::Handle, TGdiObject: ShouldDelete, 
TDib::InfoFromHandle 

Constructor TDib(const TClipboard& clipboard); 

Constructs a TDib object with a handle borrowed from the given 
Clipboard. 

See also: TDibr.InfoFromHandle, ::GetClipboardData 

Constructor TDib ( const TDib& dib); 

This public copy constructor creates a complete copy of the given dib object, 
as in: 

TDib myDib = yourDib; 

Constructor TDib (int width, int height, int nColors, WORD mode = DIB_RGB_C0L0RS) ; 

Creates a DIB object with the given width, height, number of colors, and 
mode values. 

See also: DIB RGB COLORS 
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Constructor 



Constructor 



Constructor 



Destructor 



TDib(HINSTANCE instance, TResID resID) ; 

Creates a DIB object from the resource with the given ID. 

See also: TDibr.LoadResource 

TDib(const char* name); 

Creates a DIB object from the given resource file. 

See also: TDib::LoadFile 

TDib(const TBitmapk bitmap, const TPalette* pal = 0); 

Creates a DIB object from the given resource bitmap and palette. If pal is 
(the default), the default palette is used. 

See also: TScreenDC 

-TDib ( ) ; 

Overrides the base destructor. 

See also: ~TGdiObject 



Public member functions 



ChangeModeToPal BOOL ChangeModeToPal ( const TPalettek pal) ; 

Converts the existing color table in place to use palette relative values. The 
palette that is passed is used as a reference. 

See also: TDib::ChangeModeToRGB, TPaletter.GetPaletteEntry 

ChangeModeToRGB BOOL ChangeModeToRGB (const TPalette& pal); 

Converts the existing color table in place to use absolute RGB values. The 
palette that is passed is used as a reference. Returns TRUE if the call is 
successful; otherwise returns FALSE. 



FindColor 



Findlndex 



See also: TDib::ChangeModetoPal, TPaletter.GetPaletteEntry 

int FindColor (TColor color); 

Returns the palette entry for the given color. 

See also: TDib::GetColor, TColor, TDib::SetColor 
TDibrMapColor 

int Findlndex (WORD index); 

Returns the palette entry corresponding to the given index. 
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GetBits 



GetColor 



GetColors 



Getlndex 



Getlndices 



Getlnfo 



GetlnfoHeader 



Height 



IsOK 



See also: TDib::GetIndex, TDibr.Setlndex, TDib::MapIndex 

const void HUGE* GetBits () const; 
void HUGE* GetBits ( ) ; 

Returns the Bits data member for this DIB. 

See also: TDibr.Bits 

TColor GetColor (int entry) const; 

Returns the color for the given palette entry. 

See also: TDibr.SetColor , TColor, TDibr.FindColor, TDibr.MapColor 

inline const TRgbQuad far* GetColors () const; 
inline TRgbQuad far* GetColors () ; 

Returns the bmiColors value of this DIB. 

See also: TRgbQuad 

WORD Getlndex (int entry) const; 

Returns the color index for the given palette entry. 

See also: TDibr.Setlndex, TDib::FindIndex„ TDib::MapIndex 

inline const WORD far* Getlndices () const; 
inline WORD far* Getlndices () ; 

Returns the bmiColors indices of this DIB. 

See also: TDib: -.GetColors 

inline const BITMAPINFO far* Getlnfo () const; 
inline BITMAPINFO far* GetlnfoO; 

Returns this DIB's Info field. 

See also: TDibr.Info, TDibr.GetlnfoHeader, BITMAPINFO 

inline const BITMAP I NFOHEADER far* GetlnfoHeader ()' const; 
inline BITMAPINFOHEADER far* GetlnfoHeader () ; 

Returns this DIB's bmiHeader. 

See also: TDibr.Info, TDibr.Getlnfo, BITMAPINFOHEADER 

inline int Height () const; 

Returns if Info is 0; otherwise returns H, this DIB's height. 

See also: TDibr.Info 

inline BOOL IsOKO const; 
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MapColor 



Maplndex 



NumColors 



NumScans 



operator « 



I did class 



Returns FALSE if Info is 0, otherwise returns TRUE. If there is a problem 
with the construction of the DIB, memory is freed and Info is set to 0. 
Therefore, using Info is a reliable way to determine if the DIB is constructed 
correctly. 

See also: TDib constructors, TDibr.Info 

inline BOOL IsPMO const; 

Returns TRUE if IsCore is TRUE; that is, if the DIB is an old-style PM DIB 
using core headers. Otherwise returns FALSE. 

See also: TDib::IsCore 

int MapColor (TColor fromColor, TColor toColor, BOOL doAll = FALSE); 

Maps the fromColor to the toColor in the current palette of this DIB. 
Returns the palette entry for the given color. Returns the palette entry for 
the toColor argument. 

See also: TDib::GetColor, TColor, TDib::SetColor, TDibr.FindColor 

int MapIndex(W0RD fromlndex, Word tolndex, BOOL doAll = FALSE); 

Maps the fromlndex to the tolndex in the current palette of this DIB. 
Returns the palette entry for the tolndex argument. 

See also: TDib::FindIndex, TDib::SetIndex, TDib::GetIndex 

inline long NumColors () const; 

Returns if Info is 0; otherwise returns NumClrs, the number of colors in 
this DIB's palette. 

See also: TDibr.Info 

inline int NumScans () const; 

Returns if Info is 0; otherwise returns H, the number of scans in this DIB. 

See also: TDibr.StartScan 

inline TClipboard& operator«(TClipboard& clipboard, TDib& dib); 

Writes the given dib to the given clipboard. Returns a reference to the 
resulting Clipboard, allowing the normal chaining of «. 



See also: TClipboard 

operator BITMAPINFO() operator const BITMAPINFO far* 
operator BITMAPINFO far*(); 



const; 



Typecasts this DIB by returning a pointer to its bitmap information 
structure. 
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See also: TDibr.Getlnfo, BITMAPINFO 

operator BITMAPINFOHEADER() operator const BITMAPINFOHEADER far* 

operator BITMAPINFOHEADER far* ( ) ; 



const ; 



operator 
HANDLE() 



operator 
TRgbQuadQ 



SetColor 



Setlndex 



Size 



StartScan 



ToClipboard 



Usage 



Typecasts this DIB by returning a pointer to its bitmap info header. 
See also: TDib::GetInfoHeader 

inline operator HANDLE () const; 

Typecasts this DIB by returning its Handle. 

See also: TGdiObject::Handle 

operator const TRgbQuad far*() const; 
operator TRgbQuad far*() const; 

Typecasts this DIB by returning a pointer to its colors structure. 

See also: TDib::GetColors, TRgbQuad 

void SetColor(int entry, TColor color); 

Sets the given color for the given palette entry. 

See also: TDib::GetColor, TColor, TDib::MapColor, TDibr.FindColor 

void Setlndex(int entry, WORD index); 

Sets the given index for the given entry. 

See also: TDibr.Getlndex, TDib::FindIndex, TDibr.MapIndex 

inline TSize Size() const; 

Returns TSize(0,0) if Info is 0; otherwise returns TSize(W,H), the size of this 
DIB. 

See also: TDib::Info, TSize 

inline int StartScan () const; 

Returns the DIB's starting scan line. 

See also: TDib::numScans 

void ToClipboard ( TCI ipboard& clipboard); 

Puts this DIB onto the specified Clipboard. 

See also: TClipboard 

inline, WORD Usage () const; 

Returns the Mode for this DIB. This value tells GDI how to treat the color 
table. 



150 



ObjectWindows 2.0 Reference Guide 



TDib class 



Width 



WriteFile 



See also: TDib::Mode 

inline int Width () const; 

Returns if Info is 0; otherwise returns W, the DIB width. 

See also: TDib::Info 

BOOL WriteFile (const char* filename); 

Returns TRUE if the call is successful; otherwise returns FALSE. 



Protected member functions 



InfoFromHandle void Inf oFromHandle ( ) ; 

Locks this DIB's handle and extracts the remaining data member values 
from the DIB header. 

See also: TDib::GetInfoHeader 

LoadFile BOOL LoadFile (const char* name); 

Loads this DIB from the given file name. Returns TRUE if the call is 
successful; otherwise returns FALSE. 

See also: TDib::LoadResource, TDib constructors 

LoadFteSOlirce BOOL LoadResource(HINSTANCE instance, TResID resID) ; 

Loads this DIB from the given resource and returns TRUE if successful. 
See also: TDib::LoadFile, TDib constructors 

Read BOOL Read(TFile& file, long offBits = 0); 

Reads data to this DIB, starting at offset offBits, from any file, BMP, or 
resource. Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: TDib::LoadFile 



TDibDC class 



dch 



A DC class derived from TDC, TDibDC provides access to device- 
independent bitmaps (DIBs) using the DIB. DRV driver. 

Public constructors 



Constructor 



TDibDC (const TDib& dib) ; 
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Creates a TDibDC object with the data provided by the given TDib object. 
See also: class TDib, TDCr.TDC 
Constructor TDibDC (const tdc& dc); 

Creates a TDib object compatible with the given DC argument. 
See also: TDCr.TDC 

TDocManager class docmanag.h 

TDocManager creates a document manager object that manages the list of 
current documents and registered templates, handles standard file menu 
commands, and displays the user-interface for file and view selection 
boxes. To provide support for documents and views, an instance of 
TDocManager must be created by the application and attached to the 
application. 

The document manager normally handles events on behalf of the 
documents by using a response table to process the standard 
CM_FILENEW, CM_FILEOPEN, CM_FILECLOSE, CM_FILESAVE, 
CM_FILESAVEAS, and CMVIEWCREATE File menu commands. In 
response to a CM_FILENEW or a CM_FILEOPEN command, the document 
manager creates the appropriate document based on the user's selections. 
In response to the other commands, the document manager determines 
which of the open documents contains the view associated with the 
window that has focus. The menu commands are first sent to the window 
that is in focus and then through the parent window chain to the main 
window and finally to the application, which forwards the commands to 
the document manager. 

When you create a TDocManager or a derived class, you must specify that it 
has either a multi-document (dmMDT) or single-document (dmSDT) 
interface. In addition, if you want the document manager to handle the 
standard file commands, you must OR these with dmMenu. 

You can also enable or disable the document manager menu options by 
passing dmSaveEnable or dmNoRevert in the constructor. If you want to 
enable the File I Save menu option if the document is unmodified, pass the 
dmSaveEnable flag in the constructor. To disable the "Revert to Saved" menu 
option, pass dmNoRevert in the constructor. 

When the application directly creates a new document and view, it can 
attach the view to its frame window, create MDI children, float the 
window, or create a splitter. However, when the document manager creates 
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a new document and view from the File I Open or File I New menu 
selection, the application doesn't control the process. To give the 
application control, the document manager sends messages after the new 
document and view are successfully created. Then, the application can use 
the information contained in the template to determine how to install the 
new document or view object. 

TDocManager and derived classes can be created to support specialized 
needs such as an OLE 2.0 server. 



Public data members 



DocList 



TDocument: .-List DocList; 

Holds the list of attached documents or if no documents exist. 



Public constructors and destructor 



Constructor 



Destructor 



TDocManager ( int mode ) ; 

Constructs a TDocManager object that supports either single (SDI) or 
multiple (MDI) open documents depending on the application, mode is set 
to either dmMenu, dmMDI, dmSDI, dmSaveEnable, or dmNoRevert. To install 
the standard TDocManager File menu commands, you must OR dmMDI or 
dm SDI with dmMenu. For example, 

DocManager = new TDocManager (DocMode I dmMenu); 

The document manager can then use its menu and response table to handle 
these events. If you do not specify the dmMenu parameter, you must 
provide the menu and functions to handle these commands. However, you 
can still use your application object's DocManager data member to access the 
document manager's functions. 

See also: dmxxxx document manager mode constants 

virtual -TDocManager () ; 

Destroys a TDocManager object and removes attached documents and 
templates. The constructor resets TDocTemplate::StaticHead so that it points 
to the head of the static template list. 



Public member functions 



CmFileClose 



virtual void CmFileClose I 
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CmFileRevert 



CmFileSave 



Responds to a file close message. Tests to see if the document has been 
changed since it was last saved, and if not, prompts the user to confirm the 
save operation. 

CmFileNew virtual void CmFileNewO; 

Calls CreateAnyDoc and sets dtNewDoc to a value that indicates this is a new 
document with no path specified. 

See also: TDocManager::CreateAnyDoc, dtxxxx document view constants 

CmFileOpen virtual void CmFileOpen() ; 

Lets the user select a registered template from the list displayed in the 
dialog box. Calls CreateAnyDoc. 

See also: TDocManager: -.CreateAnyDoc 

virtual void CmFileRevert () ; 

Reverts to the previously saved document. 

virtual void CmFileSave () ; 

Responds to a file save message. Set doc to the current document. Calls 
IsDirty and returns IDS_NOTCHANGED if the document hasn't been 
changed since the last time it was saved. 

CmFileSaveAs virtual void CmFileSaveAsO ; 

Prompts the user to enter a new name for the document. 

CmViewCreate virtual void CmViewCreateO ; 

Responds to a view create message by creating a document view based on 
the specified directory path. 

CreateAnyDoc virtual TDocument* CreateAnyDoc (const char far* path, long flags= 0); 

Creates a document based on the directory path and the specified template. 
flags, one of the document view constants, determines how the document 
template is created. If path is and this is not a new document (the flag 
dtNewDoc is not set), it displays a dialog box. If path is 0, dtNewDoc is not 
set, and more than one template exists, it displays a dialog box and a list of 
templates. 

See also: TDocTemplater.CreateDoc. dtxxxx document view constants 

CreateAnyView virtual TView* CreateAnyView(TDocument& doc, long flags= 0); 

Creates a document view based on the directory path and specified 
template, flags, one of the document view constants, determines how the 
document template is created. 
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See also: TDocTemplater.CreateView, dtxxxx document view constants 
DeleteTemplate void DeleteTemplate(TDocTemplate&) ; 

Removes a template from the list of templates attached to the document. 

See also: TDoeManager ::RefT emulate 

EvCanCIOSe BOOL EvCanCloseO ; 

Checks to see if all child documents can be closed before closing the current 
document. If any child returns FALSE, returns FALSE and aborts the 
process. If all children return TRUE, EvCanClose calls 
TDoeManager r.FlushDoc for each document. If FlushDoc finds that the 
document is dirty, it displays a message asking the user to save the 
document, discard any changes, or cancel the operation. If the document is 
not dirty and EvCanClose returns TRUE, EvCanClose returns TRUE. 

See also: TApplicationr.CanClose, TDoeManager r.FlushDoc 

EvPrePmcessMenu void EvPreProcessMenu(HMENU hmenu) ; 

Called from MainWindow, EvPreProcessMenu loads and deletes a menu at 
the position specified by MF_POSITION or MF_POPUP. Your application 
can call EvPreProcessMenu to process the main window's menu before it is 
displayed. 

See also: T Application: :PreProcessMenu 

FlushDoc virtual BOOL FlushDoc (TDocumentk doc); 

Updates the document with any changes and prompts the user for 
confirmation of updates. 

GetApplication - inline TApplication* GetApplicationO ; 

Returns the current application. 

GetCurrentDoc virtual TDocument* GetCurrentDoc ( ) ; 

Calls TWindow::GetFocus to determine the window with the focus. Searches 
the list of documents and returns the document that contains the view with 
the focus. Returns if no document has a view with focus. 

MatchTemplate TDocTemplate* MatchTemplate (const char far* path); 

MatchTemplate returns the first registered template whose pattern matches 
the given file name. If no template is compatible with the supplied file 
name, it returns 0. 

Pc-StDocError . virtual UINT PostDocError(TDocument& doc, UINT sid, UINT choice = MB_0K) ; 
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PostEvent 



PostEvent 
RefTemplate 

SelectAnySave 
UnRefTemplate 



Displays a message box with the error message passed as a string resource 
ID in sid. By default, the message box contains either an OK push button or 
a question mark icon. If an error message can't be found, PostDocError 
displays a "Message not found" message, choice can be one or more of the 
Windows MB_Xxxx style constants. See the Windows API online Help for a 
description of the values. This function can be overridden. 

See also: TDocument::PostError 

virtual void PostEvent (int id, TDocument& doc); 

If the current document changes, calls ::SendMessage and passes a 
WM_OWLDOCUMENT message to indicate a change in the status of the 
document. 

virtual void PostEvent (int id, TView& view); 

If the current view changes, calls ::SendMessage and passes a 
WM_OWLVIEW message to indicate a change in the status of the view. 

void RefTemplate (TDocTemplate&) ; 

Adds a template to the list of templates attached to the document. 

See also: TDocManager -.-.UnRefTemplate 

virtual TDocTemplate* SelectAnySave (TDocument&, doc, BOOL samedoc = TRUE); 

Selects a registered template to save with this document. 

void UnRef Template (TDocTemplate& ) ; 

Removes a template to the list of templates attached to the document. 

See also: TDocManager: -.RefTemplate 



Protected member functions 



SelectDocPath 



SelectDocType 



virtual int SelectDocPath (TDocTemplate** tpllist, int tplcount, char far* 

path, int buflen, long flags, BOOL save=FALSE); 

Prompts the user to select one of the templates to use for the file to be 
opened. Returns the template index used for the selection or if 
unsuccessful. For a file open operation, save is FALSE. For a file save 
operation, save is TRUE. This function can be overridden to provide a 
customized user-interface. 

virtual int SelectDocType (TDocTemplate** tpllist, int tplcount) ; - 
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SelectDocType, which can be overridden, lets the user select a document 
type from a list of document templates. Returns the template index used for 
the selection or if unsuccessful. 

SelectViewType virtual int SelectViewType(TDocTemplate** tpllist, ■ int tplcount) ; 

SelectViewType, which can be overridden, lets the user select a view name 
for a new view from a list of view names. Returns the template index used 
for the selection or if unsuccessful. 



Response table entries 



Response table entry 



Member function 



EV_COMMAND(CM_FILECLOSE, CmFileClose) CmFileClose 

EV_COMMAND(CM_FILENEW, CmFileNew), CmFileNew 

EV_COMMAND(CM_FILEOPEN, CmFileOpen) CmFileOpen 

EV_COMMAND(CM_FILEREVERT, CmFileRevert) CmFileRevert 

EV_COMMAND(CM_FILESAVE, CmFileSave) CmFileSave 

EV_COMMAND(CM_FILESAVEAS, CrnFileSaveAs) CmFileSaveAs 

EV_COMMAND(CM_VIEWCREATE, CmViewCreate) CmViewCreate 

EV_COMMAND_ENABLE(CM_FILECLOSE, CmEnableClose) CmEnableClose 

EV_COMMAND_ENABLE(CM_FILENEW, CmEnableNew) CmEnableNew 

EV_COMMAND_ENABLE(CM_FILEOPEN, CmEnableOpen) CmEnableOpen 

EV_COMMAND_ENABLE(CM_FILEREVERT, CmEnableRevert) EmEnableRevert 

EV_COMMAND_ENABLE(CM_FILESAVE, CmEnableSave) CmEnableSave 

EV_COMMAND_ENABLE(CM_FILESAVEAS, CmEnableSaveAs) CmEnableSaveAs 

EV_COMMAND_ENABLE(CM_VIEWCREATE, CmEnableCreate) CmEnableCreate 

EV_WM_OWLCANCLOSE EvCanClose 

EV WM OWLPREPROCMENU EvPreProcessMenu 



TDocTemplate class 



docmanag.h 



TDocTemplate is an abstract base class that contains document template 
functionality. TDocTemplate classes create documents and views from 
resources and handle document naming and browsing. The document 
manager maintains a list of the current template objects. Each document 
type requires a separate document template. 

Public member functions 



ClearFlag 



inline void ClearFlag (long flag); 
Clears a document view constant. 
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TDocTemplate class 



CreateDoc 



CreateView 



GetDefaultExt 



GetDescription 



GetDirectory 



GetDocManager 

GetFileFilter 

GetFlags 



GetViewName 



See also: dtxxxx document view constants 

virtual TDocument* CreateDoc (const char far* path, long flags = .0)= 0; 

A pure virtual function that must be defined in a derived class, CreateDoc 
creates a document based on the directory path (path) and the specified 
template and flags value. If the path is and the new flag (dtNewDoc) is not 
set, the dialog box is displayed. 

See also: TDocManagery.CreateAnyDoc 

virtual TView* CreateView (TDocument& doc, long flags) = 0; 

A pure virtual function that must be defined in a derived class, CreateView 
creates the view specified by the document template class. 

See also: TDocManager "Create Any View 

inline const char far* GetDefaultExt () const; 

Gets the default extension to use if the user has entered the name of a file 
without any extension. If there is no default extension, GetDefaultExt 
contains 0. 

inline const char far* GetDescription () const; 

Gets the template description to put in the file-selection list box or the File I 
New menu-selection list box. 

inline const char far* GetDirectory () const; 

Gets the directory path to use when searching for matching files. This will 
get updated if a file is selected and the dtUpdateDir flag is set. 

See also: dt document view constants 

inline -TDocManager* GetDocManager ( ) const; 

Points to the document manager. 

inline const char far* GetFileFilter () const; 

Gets any valid document matching pattern to use when searching for files. 

inline long GetFlags () const; 

Gets the document view constants, which indicate how the document is 
created and opened. 

See also: dtxxxx document view constants 

virtual const char far* GetViewName () = 0; 

A pure virtual function that must be defined in a derived class, 
GetViewName gets the name of the view associated with the template. 
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IsFlagSet 



IsMyKindOfDoc 



IsVisible 



SelectSave 



SetDefaultExt 



SetDi rectory 



SetDocManager 



SetFileFilter 



SetFlag 



inline BOOL IsFlagSet (long .flag) ; 

Returns nonzero if the document view flag is set. 

See also: dtxxxx document view constants 

virtual TDocument* IsMyKindOfDoc (TDocument& doc)=0; 

A pure virtual function that must be defined in a derived class, 
IsMyKindOfDoc tests if the template belongs to the same class as the 
document or to a derived class. 

See also: TDocTemplateT: IsMyKindOfDoc 

inline BOOL IsVisible () ; 

Indicates whether the document can be displayed in the file selection dialog 
box. A document is visible if dtHidden isn't set and Description isn't 0. 

BOOL SelectSave (TDocument& doc); 

Prompts the user to select a file name for the document. Filters out read- 
only files. 

void SetDefaultExt (const char far*); 

Sets the default extension to use if the user has entered the name of a file 
without any extension. If there is no default extension, SetDefaultExt 
contains 0. 

void SetDirectory (const char far*, int len) ; 

Sets the directory path to use when searching for matching files. This will 
get updated if a file is selected and the dtUpdateDir flag is set. 

See also: TDocTempiate: -.GetDirectory 

inline void SetDocManager (TDocManager* dm) ; 

Sets the current document manager to the argument dm: 

void SetFileFilter (const char far*); 

Sets the valid document matching pattern to use when searching for files. 

inline void SetFlag (long flag); 

Sets the document view constants, which indicate how the document is 
created and opened. 

See also: dtxxxx document view constants 



Chapter 1, Library reference 



159 



I uoc I emplate class 



Protected constructors and destructor 



Constructor 



Destructor 



TDocTemplate ( const char far* desc, const char far* filt, const char 
far* dir, const char far* ext, long flags) : 

Constructs a TDocTemplate with the specified file description (desc), file 
filter pattern (filt), search path for viewing the directory (dir), default file 
extension (ext), and flags representing the view and creation options (flags). 
Sets Description to desc, FileFilter to filt, Directory to dir, DefaultExt to ext, and 
Flags to flags. Then, adds this template to the document manager's template 
list. If the document manager is not yet constructed, adds the template to a 
static list, which the document manager will later add to its template list. 

-TDocTemplate (); 

Destroys a TDocTemplate object and frees the data members (FileFilter, 
Description, Director}/, and DefaultExt). The destructor is called only when no 
views or documents are associated with the template. Instead of calling this 
destructor directly, use the Delete member function. 

Protected member functions 



InitDoc 



InitView 



TDocument* InitDoc (TDocument* doc, const char far* path, long flags); 

Called only from the subclass to continue CreateDoc processing. 

See also: TDocTemplater.CreateDoc 

TView* InitView(TView* view); 

Called only from the subclass to continue CreateView processing. 

See also: TDocTemplate: -.CreateView 



TDocTemplateT<D,V> class 



docmanag.h 



To register the associated document and view classes, a parameterized 
subclass, TDocTemplateT<D,V>, is used to construct a particular document 
and view, where D represent the document class and V represents the view 
class. The parameterized template classes are created using a macro, which 
also generates the associated streamable support. The document and view 
classes are provided through the use of a parameterized subclass. The 
template class name is used as a typedef for the parameterized class. For 
example, 

DEFINE_DOC_TEMPLATE_CLASS(TFileDocument, TEditView, MyEditFile) 
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You can instantiate a document template using either a static member or an 
explicit construction. For example, 

MyEditFile etl("Edit text files", 

. "* .txt" , "D: Wdoc" , " .TXT" " ,dtNoAutoView) ; 
new MyEditFile ( ) 

When a document template is created, the document manager 
(TDocManager) registers the template. When the document template's delete 
function is called to delete the template, it is no longer visible to the user. 
However, it remains in memory as long as any documents still use it. 

Public constructors 

Constructor TDocTemplateT (const char far* filt, const char far* desc, const char far* 

dir, const char far* ext, long flags); 

Constructs a TDocTemplateT with, the specified file description (desc), file 
filter pattern (filt), search path for viewing the directory (dir), default file 
extension (ext), and flags representing the view and creation options (flags). 

Public member functions 



CreateDOC d* CreateDoc (const char far* path, long flags); 

CreateDoc creates a document of type D based on the directory path (path) 
and flags value. 

See also: TDocTemplater.CreateDoc 

TView* CreateView (TDocumentk doc, longflags); 

CreateView creates the view specified by the document template class. 

See also: TDocManager -.-.Create Any 'View 

D* IsMyKindOfDoc (TDocument& doc); 

IsMyKindOfDoc tests to see if the document (doc) is the same class as the 
template's document class or if the document is a derived class. If the 
template can't use the document, IsMyKindOfDoc returns 0. 

See also: TDocTemplate: -.IsMyKindOfDoc 

IsMyKindOfView v * IsMyKindOfView (TView& view) ; 

IsMyKindOfView tests to see if the view (view) is the same class as the 
template's view class or if the view is a derived class. If the template can't 
use the view, IsMyKindOfView returns 0. 



CreateView 



IsMyKindOfDoc 
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i uoc I empiateT<D,V> class 

GetViewName inline virtual const char far* GetViewName () ; 

GetViewName gets the name of the view associated with the template. 

TDocument class docview.h 

TDocument is an abstract base class that serves as an interface between the 
document, its views, and the document manager (TDocManager class). 
TDocument creates, destroys, and sends messages about the view. For 
example, if the user changes a document, TDocument tells the view that the 
document has been updated. 

In order to send messages to its associated views, the document maintains 
a list of all the views existing for that document and communicates with the 
views using ObjectWindows event-handling mechanism. Rather than using 
the function SendMessage, the document accesses the view's event table. The 
views can update the document's data by calling the member functions of 
the particular document. Views can also request streams, which are 
constructed by the document. 

Both documents and views have lists of properties for their applications to 
use. When documents and views are created or destroyed, messages are 
sent to the application, which can then query the properties to determine 
how to process the document or view. It is the document manager's 
responsibility to determine if a particular view is appropriate for the given 
document. 

Because the property attribute functions are virtual, a derived class (which 
is called first) might override the properties defined in a base class. Each 
derived class must implement its own property attribute types of either 
string or binary data. If the derived class duplicates the property names of 
the parent class, it should provide the same behavior and data type as the 
parent. See Chapter 9 in the ObjectWindows Programmer's Guide for more 
information about how to use property attributes. 

Although documents are usually associated with files, they do not 
necessarily have to be files; they can also consist of database tables, mail 
systems, fax or modem transmissions, disk directories, and so on. See 
Chapter 9 in the ObjectWindows Programmer's Guide for a visual 
representation of the general form of communication among views (some 
of which contain windows), documents, and persistent (or disk) storage. 
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TDocument class 



Public data members 



ChildDoc List ChildDoc; 

The list of child documents associated with this document. 
Property enum e num { 

PrevProperty = 0, 

DocumentClass, 

TemplateName, 

ViewCount , 

StoragePath, 

DocTitle, 

NextProperty, 



Tag 



Constructor 



Destructor 



These property values, defined for TDocument, are available in classes 
derived from TDocument. PrevProperty and NextProperty are delimiters for 
every document's property list. See Chapter 9 in the ObjectWindows 
Programmer's Guide for information about how to use these enumerated 
property values. 

LPVOID Tag; 

Tag holds a pointer to the application-defined data. Typically, you can use 
Tag to install a pointer to your own application's associated data structure. 
Tag, which is initialized to at the time a TDocument is constructed, is not 
used otherwise by the document view classes. 

Public constructors and destructor 

TDocument (TDocument* parent = 0); 

Although you don't create a TDocument object directly, you must call the 
constructor when you create a derived class, parent points to the parent of 
the new document. If no parent exists, parent is 0. 

virtual -TDocument ( ) ; 

Deletes a TDocument object. Normally, Close is called first. The ~TDocument 
destroys all children and closes all open streams. If this is the last document 
that used the template, closes the object's template, and any associated 
views, deletes the object's stream, and removes itself from the parent's list 
of children if a parent exists. If there is no parent, removes itself from the 
document manager's document list. 

See also: TDocument: :Close 
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TDocument class 



Public member functions 



CanClose 



Close 



Commit 



FindProperty 



GetDocManager 



GetDocPath 



virtual BOOL CanClose (); 

Checks to see if all child documents can be closed before closing the current 
document. If any child returns FALSE, CanClose returns FALSE and aborts 
the process. If all children return TRUE, calls TDocManagerr.FlushDoc. If 
FlushDoc finds that the document has been changed but not saved, it 
displays a message asking the user to either save the document, discard 
any changes, or cancel the operation. If the document has not been changed 
and all children's CanClose functions return TRUE, this CanClose function 
returns TRUE. 

See also: TViewr.CanClose, TDocManagerr.FlushDoc 

virtual BOOL Close ( ) ; 

Closes the document but does not delete or detach the document. Before 
closing the document, Close checks any child documents and tries to close 
them before closing the parent document. Even if you write your own Close 
function, call TDocument's version so that all child documents are checked 
before the parent document is closed. 

virtual BOOL Commit (BOOL force = FALSE); 

Saves the current data to storage. When a file is closed, the document 
manager calls either Commit or Revert. If force is TRUE, all data is written to 
storage. TDocument's Commit checks any child documents and commits 
their changes to storage also. Before the current data is saved, all child 
documents must return TRUE. If all child documents return TRUE, Commit 
flushes the views for operations that occurred since the last time the view 
was checked. Once all data for the document is updated and saved, Commit 
returns TRUE. 

See also: TDocument -.-.Revert 

virtual int FindProperty (const char far* name); 

FindProperty gets the property index, given the property name (name). 
Returns the integer index number that corresponds to the name or if the 
name isn't found in the list of properties. 

See also: pfxxxx property attribute constants, TDocument r.PropertyName 

inline TDocManager& GetDocManager () ; - 

Returns a pointer to the current document manager. 

inline LPCSTR GetDocPathO; 
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TDocument class 



GetOpenMode 



GetParentDoc 



GetProperty 



GetTemplate 



GetTitie 



HasFocus 



InStream 



IsDirty 



IsOpen 



Returns the directory path for the document. This might change the SaveAs 
operation. 

int GetOpenMode; 

Gets the mode and protection flag values for the current document. 

See also: TDocumentr.SetOpenMode 

inline TDocument* GetParentDoc () : 

Returns the parent document of the current document or if there is no 
parent document. 

virtual int GetProperty (int index, void far* dest, int textlen=0); 

Returns the total number of properties for this document where index is the 
property index, dest contains the property data, and textlen is the size of the 
array. If textlen is 0, property data is returned as binary data; otherwise, 
property data is returned as text data. 

See also: pfxxxx property attribute constants, TDocument::SetProperty 

inline TDocTemplate* GetTemplate () ; 

Gets the template used for document creation. The template can be 
changed during a SaveAs operation. 

inline LPCSTR GetTitie () ; 

Returns the title of the document. 

BOOL HasFocus (HWND hwnd) ; 

Used by the document manager to determine if the document contains a 
view with a focus. 

inline virtual TInStream* InStream (int mode, LPCSTR strmld=0); 

Generic input for the particular storage medium, InStream returns a pointer 
to a TInStream. mode is a combination of the ios bits defined in iostream.h. 
strmld is one of the shxxxx file-sharing modes, strmld is used for documents 
that support named streams. Override this function to provide streaming 
for your document class. 

See also: TDocument::OutStream 

virtual BOOL IsDirty () ; 

Returns TRUE if the document or one of its views has changed but has not 
been saved. 

inline virtual BOOL Is0pen(); 
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Checks to see if the document has any streams in its stream list. Returns 
FALSE if no streams are open; otherwise, returns TRUE. 

NextStream TStream* NextStream (const TStream* strm) ; 

Gets the next entry in the stream. Holds if none exists. 
NextView wiew* NextView( const TView* view); 

Gets the next view in the list of views. Holds if none exists. 

NotifyViewS B 00L NotifyViews(int event, long item=0, TView* excluded); 

Notifies the views of the current document and the views of any child 
documents of a change, In contrast to QueryViews, NotifyViews sends 
notification of an event to all views and returns TRUE if any views 
returned a TRUE result. The event, EV_OWLNOTIFY, is sent with an event 
code, which is private to the particular document and view class, and a 
long argument, which can be cast appropriately to the actual type passed in 
the argument of the response function. 

See also: TDocument ::Query Views 

0P en inline virtual BOOL Open(int mode, LPCSTR path = 0); 

Opens the document using the path specified by DocPath. Sets OpenMode to 
mode. TDocument's version always returns TRUE and actually performs no 
actions. Other classes override this function to open specified file 
documents and views. 

See also: TFileDocument::Open 

OutStream inline virtual TOutStream* OutStream(int mode, LPCSTR strmld = 0); 

Generic output for the particular storage medium, OutStream returns a 
pointer to a TOutStream. mode is a combination of the ios bits defined in 
iostream.h. strmld is used for documents that support named streams. 
TDocument 's version always returns 0. Override this function to provide 
streaming for your document class. 

See also: TDocument: -JnStream 

PostError virtual UINT PostError(UINT sid, UINT choice = MB_0K) ; 

Posts the error message passed as a string resource ID in sid. choice is one or 
more of the Windows MB_Xxxx style constants. See the Windows API 
online Help for a description of the values. 

See also: TDocManagerr.PostDocError 

PropertyCount inline virtual int PropertyCount () ; 



166 



ObjectWindows 2.0 Reference Guide 



TDocument class 



PropertyFlags 



PropertyName 



QueryViews 



Revert 



RootDocument 



SetDocManager 



SetDocPath 



Gets the total number of properties for the TDocument object. Returns 
NextProperty -1. 

See also: pfxxxx property attribute constants 

virtual int PropertyFlags (int index); 

Returns the attributes of a specified property given the index (index) of the 
property whose attributes you want to retrieve. 

See also: pfxxxx property attribute constants, TDocument: :FindProperty, 
TDocument: :PropertyName 

virtual const char* PropertyName (int index); 

Returns the name of the property given the index value (index). 

See also: pfxxxx property attribute constants, TDocumentr.FindProperty 

TView* QueryViews (int event, long item=0, TView* exclude=0); 

Queries the views of the current document and the views of any child 
documents about a specified event, but stops at the first view that returns 
TRUE, In contrast to NotifyViews, QueryViews returns a pointer to the first 
view that responded to an event with a TRUE result. The event, 
EV_OWLNOTIFY, is sent with an event code (which is private to the 
particular document and view class) and a long argument (which can be 
cast appropriately to the actual type passed in the argument of the response 
function). 

See also: TDocument: -.NotifyViews 

virtual BOOL Revert ( BOOL clear = FALSE); 

Performs the reverse of Commit and cancels any changes made to the 
document since the last commit. If clear is TRUE, data is not reloaded for 
views. Revert also checks all child documents and cancels any changes if all 
children return TRUE. When a file is closed, the document manager calls 
either Commit or Revert. Returns TRUE if the operation is successful. 

See also: TDocument: -.Commit 

virtual TDocumentk RootDocument ( ) ; 

Returns the this pointer as the root document. 

inline void SetDocManager (TDocManagerk dm); 

Sets the current document manager to the argument dm. 

virtual BOOL SetDocPath (LPCSTR path); 

Sets the document path for Open and Save operations. 
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SetOpenMode void SetOpenMode(int mode); 

Sets the mode and protection flag values for the current document. 
See also: TDocumentr.GetOpenMode 

SetProperty virtual BOOL SetProperty(int index, const void far* src); 

Sets the value of the property, given the index of the property, and src, the 
data type (either binary or text) to which the property must be set. 

See also: pfxxxx property attribute constants, TDocumentr.GetProperty 

SetTemplate B 00L SetTemplate(TDocTemplate* tpl) ; 

Sets the document template. However, if the template type is incompatible 
with the file, the document manager will refuse to save the file as this 
template type. 

SetTitle virtual void SetTitle(LPCSTR title); 

Sets the title of the document. 



Protected data members 



DirtyFlag 



AttachStream 



DetachStream 



BOOL DirtyFlag; 

Indicates that unsaved changes have been made to the document. Views 
can also independently maintain their local disk status. 

Protected member functions 

virtual void AttachStream (TStream& strm); 

Called from TStreatn's constructor, AttachStream attaches a stream to the 
current document. 

virtual void DetachStream (TStream& strm); 

Called from TStreatn's destructor, AttachStream detaches a stream associated 
with the current document. 
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TDocument: list class 



TDocument::List class 



docview.h 



The TDocumentr.List nested class encapsulates the chain of documents. It 
allows addition, removal, and destruction of documents from the 
document list. 



Constructor 



Destructor 



Public constructors and destructor 



ListO; 

Constructs a TDocumentr.List object. 

inline -List () ; 

Destructs a TDocumentr.List object. 



Public member functions 



Destroy 



Insert 



Remove 



void Destroy () ; 
Deletes all documents. 

BOOL Insert (TDocument* doc); 

Inserts a new document into the document list. Fails if the document 
already exists. 

BOOL Remove (TDocument* doc) ; 

Removes a document from the document list. 



TDroplnfo class 



point.h 



TDroplnfo is a simple class that supports file-name drag and drop 
operations using the Windows API WM_DROPFILES message. Each 
TDroplnfo object has a private handle to the HDROP structure returned by 
the WM_DOPFILES message. Member functions simplify calls to 
r.DragQueryFile, r.DragQuery Point, and r.DragFinish. 



Constructor 



Public constructors 



TDroplnfo (HDROP handle); 

Creates a TDroplnfo object with Handle set to the given handle. 
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TDroplnfo class 



See also: TDropInfor.Handle 



Public member functions 



DragFinish inline void DragFinishO ; 

Releases any memory allocated for the transferring of this TDroplnfo object's 
files during drag operations. 

See also: ::DragFinish 

DragQueryFile inline UINT DragQueryFile( UINT index, char far* name, UINT nameLen) 

Retrieves the name of the file and related information for this TDroplnfo 
object. If index is set to -1 (OxFFFF), DragQueryFile returns the number of 
dropped files. This is equivalent to calling DragQueryFileCount. 

If index lies between and the total number of dropped files for this object, 
DragQueryFile copies to the name buffer (of length nameLen bytes) the name 
of the dropped file that corresponds to index, and returns the number of 
bytes actually copied. 

If name is 0, DragQueryFile returns the required buffer size (in bytes) for the 
given index. This is equivalent to calling DragQueryFileNameLen. 

See also: : -.DragQueryFile, TDropInfor.DragQueryPoint, 
TDroplnfo: -.DragQueryFileCount, TDropInfor.DragQueryFileCount 

DragQueryFileCount inline UINT DragQueryFileCount (); 

Returns the number of dropped files in this TDroplnfo object. This call is 
equivalent to calling DragQueryFile(-l , 0, 0). 

See also: TDroplnfo: :DragQuery File 

DragQueryFileNameLen inline UINT DragQueryFileNameLen (UINT index) 

Returns the length of the name of the file in this TDroplnfo object 
corresponding to the given index. This call is equivalent to calling 
DragQueryFiledndex, 0, 0). 

See also: TDroplnfo: -.DragQuery File 

DragQueryPoint inline BOOL DragQueryPoint (TPoint& point) 

Retrieves the mouse pointer position when this object's files are dropped 
and copies the coordinates to the given point object, point refers to the 
{ ' window that received the WM_DROPFILES message. DragQueryPoint 

returns TRUE if the drop occurs inside the window's client area, otherwise 
FALSE. 
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operator HDROP() 



See also: r.DragQuery Point, TPoint, WM_DROPFILES 

inline operator HDROPO; 

Typecasting operator that returns Handle. 

See also: TDroplnfo: -.Handle 



TEdgeConstraint struct 



layoutco.h 



TEdgeConstraint adds member functions that set edge (but not size) 
constraints. TEdgeConstraint always places your window one pixel above 
the other window and then adds margins. For example, if the margin is 4, 
TEdgeConstraint places your window 5 pixels above the other window. The 
margin, which does not need to be measured in pixels, is defined using the 
units specified by the constraint. Therefore, if the margin is specified as 8 
layout units (which are then converted to 12 pixels), your window would 
be placed 13 pixels above the other window. See TLayoutWindow for an 
example of layout constraints. 

See also: TLayoutConstraint 

Public member functions 



Above 



Absolute 



Below 



inline void Above (TWindow * sibling, int margin = 0) 

Positions your window above a sibling window. You must specify the 
sibling window and an optional margin between the two windows. If no 
margin is specified, Above sets the bottom of one window one pixel above 
the top of the other window. 

See also: TEdgeConstraint r.Belozv 

inline void Absolute (TEdge edge, int value) 
Sets an edge of your window to a fixed value. 
See also: TEdgeConstraintr.PercentOf 

inline void Below(TWindow *sibling, int margin = 0); 

Positions your window with respect to a sibling window. You must specify 
the sibling window and an optional margin between the two windows. If 
no margin is specified, Below sets the top of one window one pixel below 
the bottom of the other window. 

See also: TEdgeConstraint:: Above 
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TEdgeConstraint struct 



LeftOf 



PercentOf 



RightOf 



SameAs 



Set 



inline void LeftOf (TWindow *sibling, int margin =0) 

Positions one window with respect to a sibling window. You can specify 
the sibling window and an optional margin between the two windows. 

See also: TEdgeConstraint:: RightOf 

inline void PercentOf (TWindow *otherWin, TEdge edge, int percent) 

Specifies that the edge of one window indicated in edge should be a 
percentage of the corresponding edge of another window or otherWin. 

inline void RightOf (TWindow *sibling, int margin = 0) 

Positions one window with respect to a sibling window. You can specify 
the sibling window and an optional margin between the two windows. 

See also: TEdgeConstraint r.LeftOf 

inline void SameAs (TWindow *otherWin, TEdge edge) 

Sets the edge of your window indicated by edge equivalent to the 
corresponding edge of the window in otherWin. 

See also: TEdgeConstraint:: Set 

inline void Set (TEdge edge, TRelationship rel, TWindow *otherWin, 
TEdge otherEdge, int value = 0); 

Used for setting arbitrary edge constraints, Set specifies that your window's 
edge should be of a specified relationship to other Win's specified edge. 

See also: TEdgeConstraint:: SameAs 



TEdgeOrSizeConstraint struct 



layoutco.h 



Derived from TEdgeConstraint, TEdgeOrSizeConstraint is a template class 
that supports size constraints in addition to all the operations that 
TEdgeConstraint provides. The width or height is specified in the template 
instantiation of this class. There are two versions of each member function: 
one sets both edge and size constraints; the other sets only edge constraints. 

Public member functions 



Absolute 



inline void Absolute (int value) 

Sets the width or height of your window to a fixed value. 
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TEdgeOrSizeConstraint struct 



Absolute 



PercentOf 



PercentOf 



SameAs 



SameAs 



inline void Absolute (TEdge edge, int value) 

Used to determine edge constraints only, Absolute sets the edge of your 
window to a fixed value. 

See also: TEdgeConstraint:: Absolute 

inline void PercentOf (TWindow *otherWin, int percent, 

TWidthHeight otherWidthHeight = widthOrHeight) 

Although a window's width or height defaults to being a percentage of the 
sibling or parent window's corresponding dimension, it can also be a 
percentage of the sibling or parent's opposite dimension. For example, one 
window's width can be 50% of the parent window's height. 

See also: TEdgeOrSizeConstraint:: Absolute 

inline void PercentOf (TWindow *otherWin, TEdge edge, int percent) 

Used to determine edge constraints only, PercentOf specifies that the edge 
of one window indicated in edge should be a percentage of the 
corresponding edge of another window or otherWin. 

See also: TEdgeConstraint: -.PercentOf 

inline void SameAs (TWindow *otherWin, 

TWidthHeight otherWidthHeight = widthOrHeight, 
int value = 0) 

Although a window's width or height defaults to being the same as the 
sibling or parent window's corresponding dimension, it can be the same of 
the sibling's or parent's opposite dimension. For example, one window's 
width can be the same as the parent window's height. 

See also: TEdgeOrSizeConstraintr.PercentOf 

inline void SameAs (TWindow *otherWin, TEdge edge) 

Used to determine edge constraints only, SameAs sets the edge of one 
window the same as the corresponding edge of the other window specified 
in otherWin. 

See also: TEdgeConstraint:: SameAs 



TEdit class 



edit.h 



A TEdit is an interface object that represents an edit control interface 
element in Windows. A TEdit object must be used to create an edit control 
in a parent TWindow. A TEdit can be used to facilitate communication 
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between your application and the edit controls of a TDialog. This class is 
streamable. 

There are two styles of edit control objects: single line and multiline. 
Multiline edit controls allow editing of multiple lines of text. 

The position of the first character in an edit control is zero. For a multiline 
edit control, the position numbers continue sequentially from line to line; 
line breaks count as two characters. 

Most of TEdit's member functions manage the edit control's text. TEdit also 
includes some automatic member response functions that respond to selec- 
tions from the edit control's parent window menu, including cut, copy, and 
paste. Two important member functions inherited from TEdit's base class 
(TStatic) are GetText and SetText. 

Public constructors 

Constructor TEdit (TWindow* parent, int Id, const char far *text, int x, int y, int w, 

int h, UINT textLen, BOOL multiline = FALSE, TModule* module = 0); 

Constructs an edit control object with a parent window (parent). Sets the 
creation attributes of the edit control and fills its Attr data members with 
the specified control ID (Id), position (x, y) relative to the origin of the 
parent window's client area, width (w), and height (h). 

If text buffer length (textLen) is or 1, there is no explicit limit to the num- 
ber of characters that can be entered. Otherwise textLen - 1 characters can 
be entered. By default, initial text (text) in the edit control is left-justified 
and the edit control has a border. Multiline edit controls have horizontal 
and vertical scroll bars. 

Constructor TEdit (TWindow* parent, int resourcelD, UINT textLen, TModule* module = 0); 

Constructs a TEdit object to be associated with an edit control of a TDialog. 
Invokes the TStatic constructor with identical parameters. The resourcelD 
parameter must correspond to an edit resource that you define. Enables the 
data transfer mechanism by calling EnableTransfer. 

See also: TSiatic::TStatic 



Public member functions 



CanUndo 



BOOL CanUndo (); 

Returns TRUE if it is possible to undo the last edit. 
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ClearModify 



Copy 

Cut 

DeleteLine 



DeleteSelection 



DeleteSubText 



See also: TEdit::Undo 

void ClearModify () ; 

Resets the change flag of the edit control causing IsModified to return 
FALSE. The flag is set when text is modified. 

See also: TEdit: :IsModified 

void Copy ( ) ; 

Copies the currently selected text into the Clipboard. 

void Cut ( ) ; 

Deletes the currently selected text and copies it into the Clipboard. 

BOOL DeleteLine (int lineNumber) ; 

Deletes the text in the line specified by lineNumber in a multiline edit 
control. If -1 passed, deletes the current line. DeleteLine does not delete the 
line break and affects no other lines. Returns TRUE if successful. Returns 
FALSE if lineNumber is not -1 and is out of range or if an error occurs. 

BOOL DeleteSelection () ; 

Deletes the currently selected text, and returns FALSE if no text is selected. 

BOOL DeleteSubText (UINT startPos, UINT endPos); 

Deletes the text between the starting and ending positions specified by 
startPos and endPos, respectively. DeleteSubText returns TRUE if successful. 



EmptyUndoBuffer vo id EmptyUndoBuffer! 



FormatLines 



GetFirstVisibleLine 



GetHandle 



If an operation inside the edit control can be undone, the edit control undo 
flag is set. EmptyUndoBuffer resets or clears this flag. 

inline void FormatLines (BOOL addEOL) ; 

Indicates if the end-of-line characters (carriage return, linefeed) are to be 
added or removed from text lines that are wordwrapped in a multiline edit 
control. Returns TRUE if these characters are placed at the end of 
wordwrapped lines or FALSE if they are removed. 

inline int GetFirstVisibleLine () const; 

Indicates the topmost visible line in an edit control. For single-line edit 
controls, the return value is 0. For multiline edit controls, the return value is 
the index of the topmost visible line. 

inline HANDLE GetHandle () const; 
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GetLine 



GetLineFromPos 



GetLinelndex 



GetLineLength 



GetNumLines 



GetPasswordChar 



Returns the data handle of the buffer that holds the contents of the control 
window. 

See also: :TEdit::SetHandle 

BOOL GetLine (char far* str, int strSize, int lineNumber); 

Retrieves a line of text (whose line number is supplied) from the edit 
control and returns it in str (NULL-terminated). str Size indicates how many 
characters to retrieve. GetLine returns FALSE if it is unable to retrieve the 
text or if the supplied buffer is too small. 

See also: TStatic::GetText, TEdit ::GetNumLines, TEdit ::GetLineLength 

inline int GetLineFromPos (UINT charPos); 

From a multiline edit control, returns the line number on which the char- 
acter position specified by charPos occurs. If charPos is greater than the 
position of the last character, the number of the last line is returned. If 
charPos is-1, the number of the line that contains the first selected character 
is returned. If there is no selection, the line containing the caret is returned. 

See also: ::EM__LINEFROMCHAR 

inline UINT GetLinelndex (int lineNumber) ; 

In a multiline edit control, GetLinelndex returns the number of characters 
that appear before the line number specified by lineNumber. If lineNumber is 
-1, GetLinelndex returns the number of the line that contains the caret is 
returned. 

See also: ::EM_LINEINDEX 

int GetLineLength (int lineNumber); 

From a multiline edit control, GetLineLength returns the number of 
characters in the line specified by lineNumber. If it is -1, the following 
applies: if no text is selected, GetLineLength returns the length of the line 
where the caret is positioned; if text is selected on the line, GetLineLength 
returns the line length minus the number of selected characters; if selected 
text spans more than one line, GetLineLength returns the length of the lines 
minus the number of selected characters. 

inline int GetNumLines () ; 

Returns the number of lines that have been entered in a multiline edit 
control: 1 if the edit control has no text (if it has one line with no text in it), 
or if there is no text or if an error occurs. 

See also: ::EM_GETNUMLINES 

inline UINT GetPasswordChar () const; 
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GetRect 



GetSelection 



GetSubText 



GetWordBreakProc 



Insert 



IsModified 



LockBuffer 



Returns the character to be displayed in place of a user-typed character. 
When the edit control is created with the ES_PASSWORD style specified, 
the default display character is an asterisk (*). 

See also: TEdit::SetPasswordChar, ::EM_GETPASSWORDCHAR, 
::ES_PASSWORD 

inline void GetRect (TRect& frmtRect) const; 

Gets the formatting rectangle of a multiline edit control. 

See also: TEdit: :SetRect, TEdit ::SetRectNP, ::EM_GETRECT 

inline void GetSelection (UINT& startPos, UINT& endPos); 

Returns the starting (startPos) and ending (endPos) positions of the currently 
selected text. By using GetSelection in conjunction with GetSubText, you can 
get the currently selected text. 

See also: TEdit: -.GetSubText 

void GetSubText (char far* str, UINT startPos, UINT endPos); 

Retrieves the text in an edit control from indices startPos to endPos and 
returns it in str. 



See also: TEdit: -.GetSelection 

inline EDITWORDBREAKPROC GetWordBreakProc i 



const; 



Retrieves the current wordwrap function. Returns the address of the 
wordwrap function defined by the application or if none exists. 

See also: TEdit:: Set WordBreakProc, ::EM_GETWORDBREAKPROC 

inline void Insert (const char far* str); 

Inserts the text supplied in str into the edit control at the current text 
insertion point (cursor position), and replaces any currently selected text. 
Insert is similar to Paste, but does not affect the Clipboard. 

See also: TEditr.Paste 

BOOL IsModifiedO; 

Returns TRUE if the user has changed the text in the edit control. 

See also: TEdit r.ClearModify 

char far* LockBuffer (UINT newsize=0); 

Locks the edit control's buffer and returns a pointer to the buffer. Passing 
newsize greater than causes the buffer to be resized to newsize. You must 
call Unlock when you are finished. 
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Paste 



Scroll 



Search 



SetHandle 



SetPasswordChar 



SetReadOnly 



SetRect 



SetRectNP 



See also: TEdit: :UnLockBuffer 

void Pasted ; 

Inserts text from the Clipboard into the edit control at the current text 
insertion point (cursor position). 

See also: TEdit: :CMEditPaste 

inline void Scroll (int horizontalUnit, int verticalUnit); 

Scrolls a multiline edit control horizontally and vertically using the 
numbers of characters specified in horizontalUnit and verticalUnit. Positive 
values result in scrolling to the right or down in the edit control, and 
negative values result in scrolling to the left or up. 

int Search (UINT startPos, const char far* text, BOOL caseSensitive=FALSE, 
BOOL wholeWord=FALSE, BOOL up=FALSE) ; 

Performs either a case-sensitive or case-insensitive search for the supplied 
text. If the text is found, the matching text is selected, and Search returns the 
position of the beginning of the matched text. If the text is not found in the 
edit control's text, Search returns -1. If -1 is passed as startPos, then the 
search starts from either the end or the beginning of the currently selected 
text, depending on the search direction. 

inline void SetHandle (HLOCAL localMem) ; 

Sets a handle to the text buffer used to hold the contents of a multiline edit 
control. 

See also: :TEdit::GetHandle 

void SetPasswordChar (UINT ch) ; 

SetPasswordChar sets the character to be displayed in place of a user-typed 
character. When the ES_PASSWORD style is specified, the default display 
character is an asterisk (*). 

See also: TEdit r.GetPasswordChar, ::ES_PASSWORD 

inline void SetReadOnly (BOOL readonly); 

Sets the edit control to be read-only or read-write. 

inline void SetRect (const TRectk frmtRect); 

Sets the formatting rectangle for a multiline edit control. 

See also: TEdit ::GetRect, TEdit:: SetRectNP 

inline void SetRectNP (const TRect& frmtRect); 
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SetSelection 



SetTabStops 



SetWordBreakProc 



Undo 



UnlockBuffer 



Validator 



CanClose 



Sets the formatting rectangle for a multiline edit control. Unlike SetRect, 
SetRectNP does not repaint the edit control. 

See also: TEdit::GetRect, TEdit: -.SetRect 

inline BOOL SetSelection (UINT startPos, UINT endPos); 

Forces the selection of the text between the positions specified by startPos 
and endPos, but not including the character at endPos. 

void inline SetTabStops (int numTabs, const int far* tabs); 

Sets the tab stop positions in a multiline edit control. 

inline void SetWordBreakProc (EDITWORDBREAKPROC proc); 

In a multiline edit control, SetWordBreakProc indicates that an application- 
supplied word-break function has replaced the default word-break 
function. The application-supplied word-break function might break the 
words in the text buffer at a character other than the default blank 
character. 

See also: TEdit::GetWordBreakProc 

void Undo ( ) ; 

Undoes the last edit. 

See also: TEdit r.Canllndo, TEdit: :CMEditUndo 

void UnlockBuffer (const char far* buffer, BOOL updateHandle=FALSE) ; 

Unlocks a locked edit control buffer. If the contents were changed, 
updateHandle should be TRUE. 

See also: TEdit ::LockBuffer 

Protected data members 

TValidator* Validator; 

Points to the validator object constructed in your derived class to validate 
input text. If no validator exists, Validator is zero. 

Protected member functions 

BOOL CanClose ( ) ; 

Checks to see if all child windows can be closed before closing the current 
window. If any child window returns FALSE, CanClose returns FALSE and 
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CmEditClear 



CmEditCopy 



CmEditCut 



CmEditDelete 



CmEditPaste 



CmEditUndo 



ENErrSpace 



EvChar 



terminates the process. If all child windows can be closed, CanClose returns 
TRUE. 

void CmEditClear () ; 

Automatically responds to a menu selection with a menu ID of 
CM_EDITCLEAR by calling Clear. 

See also: TStaticr.Clear 

void CmEditCopy () ; 

Automatically responds to a menu selection with a menu ID of 
CM_EDITCOPY by calling Copy. 

See also: TEdit: :Copy 

void CmEditCut ( ) ; 

Automatically responds to a menu selection with a menu ID of 
CM_EDITCUT by calling Cut. 

See also: TEdit::Cut 

void CmEditDelete (); 

Automatically responds to a menu selection with a menu ID of 
CM_EDITDELETE by calling DeleteSelection. 

See also: TEdit "DeleteSelection 

void CmEditPaste ( ) ; 

Automatically responds to a menu selection with a menu ID of 
CM_EDITPASTE by calling Paste. 

See also: TEditr.Paste 

void CmEditUndo ( ) ; 

Automatically responds to a menu selection with a menu ID of 
CM_EDITUNDO by calling Undo. 

See also: TEditr.Undo 

void ENErrSpace ( ) ; 

Sounds a beep in response to an error notification message that is sent 
when the edit control unsuccessfully attempts to allocate more memory. 

void EvChar (UINT key, UINT repeatCount, UINT flags); 

Validates the text entered into the edit control. If the input is incorrect, the 
original text is restored. Otherwise, the validated and modified text is 
placed back into the edit control, so the results of the auto-fill (if any) can be 
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viewed. When IsValidlnput is called, the SupressFill parameter defaults to 
False, so that the string can be modified. 

EvGetDlgCode uiNT EvGetDlgCode ( ) ; c 

Responds to the GetDlgCode query according to the current state of the 
control. If the edit control contains valid input, then Tabs are allowed for 
changing focus. 

EvKeyDown vo id EvKeyDown (UINT key, UINT repeatCount, UINT flags); 

EvKeyDown translates the virtual key code into a movement, key indicates 
the virtual key code of the pressed key, repeatCount holds the number of 
times the same key is pressed, flags contains one of the messages that 
translates to a virtual key (VK) code for the mode indicators. If the Tab key 
is sent to the Edit Control, EvKeyDown checks the validity before allowing 
the focus to change. 

EvKl'IIFoCUS void EvKillFocus (HMD hWndGetFocus); 

In response to a WM_KILLFOCUS message sent to a window that is losing 
the keyboard, EvKillFocus hides and then destroys the caret. EvKillFocus 
validates text whenever the focus is about to be lost and holds onto the 
focus if the text is not valid. Doesn't kill the focus if another application, a 
Cancel button, or an OK button (in which case CanClose is called to validate 
text) has the focus. 

GetClassName char far* GetClassNameO ; 

Returns the name of TEdit's Windows registration class, "EDIT." 

See also: T Window: :GetClassName 
SetupWindoW void SetupWindowO ; 

If the textLen data member is nonzero, SetupWindow limits the number of 
characters that can be entered into the edit control to textLen -1. 

See also: T Static: -.TextLen, TWindowr.SetupWindow 

Response table entries 



Response table entry 



Member function 



EV_COMMAND (CM_EDITCLEAR, CmEditClear) 
EV_COMMAND (CM_EDITCOPY, CmEditCopy) 
EV_COMMAND (CM_EDITCUT, CmEditCut) 
EV_COMMAND (CM_EDITDELETE, CmEditDelete) 
EV_COMMAND (CM_EDITPASTE, CmEditPaste) 



CmEditClear 

CmEditCopy 

CmEditCut 

CmEditClear 

CmEditPaste 
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Response table entry 



Member function 



EV_COMMAND (CM_EDITUNDO, CmEditUndo) CmEditUndo 

EV_COMMAND_ENABLE(CM_EDITCLEAR, CmCharsEnable) CmCharsEnable 

EV_COMMAND_ENABLE(CM_EDITCOPY, CmSelectEnable) CmSelectEnable 

EV_COMMAND_ENABLE(CM_EDITCUT, CmSelectEnable) CmSelectEnable 

EV_COMMAND_ENABLE(CM_EDITDELETE, CmSelectEnable) CmSelectEnable 

EV_COMMAND_ENABLE(CM_EDITPASTE, CmPasteEnable) CmPasteEnable 
EV_COMMAND_ENABLE(CM_EDITUNDO, CmModEnable) . CmModEnable 

EV_NOTIFY_AT_CHILD (EN_ERRSPACE, ENErrSpace) ENErrSpace 

EV_WM_CHAR EvChar 

EV_WM_GETDLGCODE EvGetdlgcode 

EV_WM_KEYDOWN EvKeydown 

EV_WM_KILLFOCUS EvKillFocus 

EV WM CHILDINVALID EvChildlnvalid 



TEditFile class 



editfile.h 



TEditFile is a file-editing window. TEditFile's data members and member 
functions manage the file dialog box and automatic responses for file 
commands such as Open, Read, Write, Save, and SaveAs. TEditFile is 
streamable. 

Public data members 



FileData 



FileName 



TOpenSaveDialog: :TData FileData; 

Contains information about the user's file open or save selection. 

See also: TOpenSaveDialogr.TData 

char far* FileName; 

Contains the name of the file being edited. 



Public constructors and destructor 



Constructor 



Destructor 



TEditFile (TWindow* parent = 0, int Id 
const char far* fileName = C 



0, const char far* text 
TModule* 'module = 0) ; 



Constructs a TEditFile window given the parent window, resource ID (Id), 
text, file name, and module ID. Sets Filename to fileName. 



-TEditFile I 
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CanCiear 



CanClose 



CmFileNew 



CmFileOpen 



CmFileSave 



CmFileSaveAs 



NewFile 



Open 



Frees memory allocated to hold the name of the TEditFile. 

Public member functions 

virtual BOOL CanCiear (); 

Returns TRUE if the text of the associated edit control can be cleared. 

virtual BOOL CanClose (); 

Returns TRUE if the edit window can be closed. 

inline void CmFileNewO ; 

Calls NewFile in response to an incoming File New command with a 
CM_FILENEW command identifier. 

See also: TEditFile: :NewFile 

inline void CmFileOpen () ; 

Calls Open in response to an incoming File Open command with a 
CM_FILEOPEN command identifier. 

See also: TEditFile: :Open 

inline void CmFileSave () ; ■ 

Calls Save in response to an incoming File Save command with a 
CMJFILESAVE command identifier. 

See also: TEditFile:: Save 

inline void CmFileSaveAs ()';' 

Calls SaveAs in response to an incoming File SaveAs command with a 
CM_FILESAVEAS command identifier. 

See also: TEditFile::SaveAs 

void NewFile ()•; 

Begins the edit of a new file after calling CanCiear to determine that it is safe 
to clear the text of the editor. 

See also: TEditFile: :CanClear 

Open ( ) ; 

Opens a new file after determining that it is OK to clear the text of the 
Editor. Calls CanCiear, and if TRUE is returned, brings up a file dialog box 
to retrieve the name of a new file from the user. Calls ReplaceWith to pass 
the name of the new file. 
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Save 



SaveAs 



See also: TEditFile::CanClear, TEditFile: :ReplaceWith 

Read BOOL Read (const char far* fileName=0) ; 

Reads the contents of a previously specified file into the Editor. Returns 
TRUE if read operation is successful. 

ReplaceWith vo id ReplaceWith (const char far* fileName); 

Calls SetFileName and Read to replace the file currently being edited with a 
file whose name is supplied. 

See also: TEditFile:: SetFileName, TEditFile: :Read 

BOOL Save ( ) ; 

Saves changes to the contents of the Editor to a file. If Editor->IsModified 
returns FALSE, Save returns TRUE, indicating there have been no changes 
since the last open or save. 

See also: TEditFile: SaveAs, TEditFile::Write 

BOOL SaveAs (); 

Saves the contents of the Editor to a file whose name is retrieved from the 
user, through execution of a File Save dialog box. If the user selects OK, 
SaveAs calls SetFileName and Write. Returns TRUE if the file was saved. 

See also: TEditFile::SetFileName,TEditFile::Write 

void SetFileName (const char far* fileName) ; 

Sets FileName and updates the caption of the window. 

, BOOL Write(const char far* fileName=0); 

Saves the contents of the Editor to a file whose name is specified by 
FileName. Returns TRUE if the write operation is successful. 

Protected member functions 

SetupWindoW void SetupWindowO; 

Creates the edit window's Editor edit control by calling 

TEditFile: :SetupWindow. Sets the window's caption to FileName, if available; 

otherwise sets the name to "Untitled." 

See also: TEditFile: -.SetFileName, TEditFile: :Read 



SetFileName 



Write 
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Response table entry 



TEditFile class 



Member function 



EV_COMMAND (CM_FILENEW, CmFileNew) CmFileNew 

EV_COMMAND (CM_FILEOPEN, CmFileOpen) CmFileOpen 

EV_COMMAND (CM_FILESAVE, CmFileSave) ^ CmFileSave 
EV_COMMAND (CM_FILESAVEAS, CmFileSaveAs) CmFileSaveAs 



TEditSearch class 



editsear.h 



SearchCmd 



Search Data 



Search Dialog 



Constructor 



TEditSearch is an edit control that responds to Find, Replace, and FindNext 
menu commands. This class is streamable. 

Public data members 

UINT SearchCmd; 

Contains the search command identifier that opened the dialog box if one is 
open. 

TFindReplaceDialog: :TData SearchData; 

The SearchData structure defines the search text string, the replacement text 
string, and the size of the text buffer. 

See also: TFindReplaceDialog: :TData 

TFindReplaceDialog* SearchDialog; . 

Contains find or replace dialog-box information (such as the text to find 
and replace) and check box settings. 

Public constructors 

TEditSearch (TWindow* parent =0, int Id = 0, const char far* text =0, 
TModule* module = 0) ; 

Constructs a TEditSearch object given the parent window, resource ID, and 
character string (text). 
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Public member functions 



CmEditFind 



CmEditFindNext 



CmEditReplace 



DoSearch 



EvFindMsg 



SetupWindow 



void CmEditFind (); 

Opens a TFindDialog in response to an incoming Find command with a 
CM_EDITFIND command. 

void CmEditFindNext (); 

Responds to an incoming FindNext command with a CM_EDITFINDNEXT 
command identifier by calling DoSearch to repeat the search operation. 

See also: TEditSearch::DoSearch 

void CmEditReplace ( ) ; 

Opens a TReplaceDialog in response to an incoming Replace command with 
a CM_EDITREPLACE command. 

void DoSearch () ; 

Performs a search or replace operation base on information in SearchData. 

See also: TFindReplaceDialogr.TData 

LRESULT EvFindMsg (WPARAM, LPARAM) ; 

Responds to a message sent by the modeless find or replace dialog box. 
Calls DoSearch to continue searching if text is not found or the end of the 
document has not been reached. 

See also: TEditSearchr.DoSearch 

void SetupWindow () ; ' . 

Posts a CM_EDITFIND or a CM_EDITREPLACE message to re-open a find 
or replace modeless dialog box. Calls TEdit:: SetupWindow. 

See also: Tedit::SetupWindow 

Response table entries 



Response table entry 



Member function 



EV_COMMAND(CM_EDITFIND,CmEditFind) CmEditFind 

EV_COMMAND(CM_EDITFINDNEXT, CmEditFindNext) CmEditFindNext 

EVCOMMAND(CM_EDITREPLACE, CmEditReplace) CmEditReplace 

EV_REGISTERED(FINDMSGSTRING, EvFindMsg) EvFindMsg , 
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editview.h 



Derived from TView and TEditSearch, TEditView provides a view wrapper 
for ObjectWindows text edit class (TEdit). A streamable class, TEditView 
includes several event-handling functions that handle messages between a 
document and its views. 



Public constructors and destructor 



Constructor 



Destructor 



TEditView (TDocumentk doc, TWindow* parent = 0) ; 

Creates a TEditView object associated with the specified document and 
parent window. Sets Attr.AccelTable to IDA JEDITVIEW to identify the edit 
view. Sets TViewr.ViewMenu to the new TMenuDescr for this view. 

-TEditView () 

Destroys a TEditView object. 



Public member functions 



CanClose 



Create 



GetViewName 



GetWindow 



PerformCreate 



inline BOOL CanCloseO; 

Returns nonzero if the view can be closed. 

See also: TEditFile::CanClose 

BOOL Create () 

Overrides TWindow: -.Create and calls TEditSearch: -.Create to create the view's 
window. Calls GetDocPath to determine if the file is new or already has 
data. If there is data, calls LoadData to add the data to the view. If the view's 
window can't be created, Create indicates the view is invalid. 

inline LPCSTR GetViewName () ; 

Overrides TView: -.GetViewName and returns the descriptive name of the 
class (StaticName). 

See also: TEditViewr.StaticName, TView::GetViewName 

inline TWindow* GetWindowO; 

GetWindoxv overrides GetWindow in TView and returns this as a TWindow. 

See also: TView ::Get Window 

void PerformCreate (int menuOrld) ; 
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Allocates memory as necessary so that TEditView can handle files up to and 
including 30,000 bytes. , 

SetDocTitle inline BOOL SetDocTitle(LPCSTR docname, int index) 

Overrides TViezv:: SetDocTitle and forwards the title to its base class, 
TEdit Search. 

See also: TWindow:: SetDocTitle, TViezv:: SetDocTitle 

StatiCName 'inline static LPCSTR StaticNameO ; 

Returns "Edit View," the descriptive name of the class for the ViewSelect 
menu. 



Protected data member 



Origin 



long Origin; 

Holds the file position at the beginning of the display. 



Protected member functions 



EvNCDestroy 



LoadData 



VnCommit 



VnDocClosed 



VnlsDirty 



void EvNCDestroy () ; 

EvNcDestroy is used internally by TEditView to manage memory. 

BOOL LoadData ( ) ; 

LoadData reads the view from the stream and closes the file. It returns 
nonzero if the view was successfully loaded. If the file can't be read, posts 
an error and returns 0. 

BOOL VnCommit (BOOL force );. 

VnCommit commits changes made in the view to the document. If force is 
nonzero, all data, even if it's unchanged, is saved to the document. 

See also: TEditViewr.vnRevert, vnxxxx view notification constants 

BOOL VnDocClosed (int omode) ; 

VnDocClosed indicates that the document has been closed, mode is one of the 
ofxxxx document open constants. 

See also: ofxxxx document open enum, vnxxxx view notification constants 

inline BOOL VnlsDirty (); 

VnlsDirty returns nonzero if changes made to the data in the view have not 
been saved to the document; otherwise, it returns 0. 
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See also: vnxxxx view notification constants 

VnlsWindOW inline BOOL VnIsWindow(HWND hWnd) ; 

VnlsWindow returns nonzero if the window's handle passed in hWnd is the 
same as that of the view's display window. 

VnRevert B 00L VnRevert(B00L clear) ; 

VnRevert is nonzero if changes made to the view should be erased, and the 
data from the document should be restored to the view. If clear is nonzero, 
the data is cleared instead of restored to the view. 

See also: TEditView: -.Commit 



Response table entries 






Response table entry 


Member function 



EV VN COMMIT 


VnCommit 


EV VN DOCCLOSED 


VnDocClosed 


EV_VN ISDIRTY 


VnlsDirty 


EV VN ISWINDOW 


VnlsWindow 


EV_WM_NCDESTROY 


EvNcDestroy 


EV VN REVERT 


VnRevert 



TEventHandler class 



eventhan.h 



Dispatch 



Find 



TEventHandler is a base class from which you can derive classes that handle 
messages. See Chapter 2 for a list of the Windows messages that 
ObjectWindows handles. 

Public member functions 

virtual LRESULT Dispatch (TEventInfo&, WPARAM, LPARAM = 0) ; 

Takes the message data from Msg and dispatches it to the correct event 
handler. 

virtual BOOL Find(TEventInfo&, TEqualOperator = 0); 

Searches the list of response table entries looking for a match. Because 
TEventHandler doesn't have any entries, TEventHandler'^ implementation of 
this routine returns FALSE. 
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TEventHandler class 



Protected member functions 



SearchEntrieS £oOL SearchEntries (TGenericTableEntry RTFAR* entries, TEventInfo&,- 

TEqualOperator) ; 

Searches the entries in the response table for an entry that matches 
TEventlnfo or, if so designated, an entry that TEqualOperator specifies is a 
match. 

TEventHandler: :TEqualOperator type eventhan.h 

A nested class, TequalOperator is used to perform special kinds of searches 
and to faciliate finding response table entries. TEqualOperator compares a 
particular message event (TEventInfo&) with a response table entry 
(TGenericTableEntry) to determine if they match. 

typedef BOOL(*TEquaiOperator) (TGenericTableEntry RTFAR&, TEventInfo&) ; 

See also: TResponseTableEntry 

TEventHandler: :TEventlnfo class eventhan.h 

A nested class, TEventlnfo provides specific information about the type of 
message sent, the class that contains the function to be handled, the 
corresponding response table entry, and the dispatch function that 
processes the message. 

Public data members 

Dispatch ■ LRESULT Dispatch (GENERIC Sobject, TGenericTableEntry Sentry, 

WPARAM wParam, LPARAM lParam) ; 

Generic dispatch function to crack and dispatch Windows messages. 
GENERIC &object is the pointer to the object (for example, TEdit); 
TGenericTAbleEntry &entry is the response table entry (for example, 
Ev Activate); WPARAM and LPARAM are the message parameters the 
dispatcher cracks. 

F i nd ■ virtual TGenericTableEntry *Find(GENERIC *&object, UINT.msg, UINT Id, 

TEqualOperator = 0); ' . 

Find locates and returns an entry that a TEventHandler class can respond to. 

M s 9 const UINT Msg; 
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TEventHandler::TEventlnfo class 



Contains the type of message sent. These can be command messages, child 
id messages, notify-based messages such as LBN_SELCHANGE, or 
windows messages such as LBUTTONDOWN. 



Id 



const UINT Id; 

Contains the menu or accelerator resource ID (CM_xxxx) for the message 
response member function. 

Object GENERIC *0bject; 

Points to the object that contains the function to be handled. 
Entry TGenericTableEntry _RTFAR *Entry; 

Points to the response table entry, for example Ev Activate. 



Public constructors 



Constructor 



TEventInfo(UINT rasg, UINT id = 0) : Msg(msg), Id(id); 

Constructs a TEventlnfo object with the specified ID and message type. 



TEventStatus enum window.h 

Event status constants indicate the status of a mix-in window event 
implementation. For example, depending on the implementation of a 
keyboard event, DoKeyDown and DoSetFocus return one of TEventStatus 
constants. 

Table 1 .27 — ~ 

Event status Constant Meaning 

constants : 

esPartial Additional handlers can be invoked 

esComplete No additional handlers are needed 

See also: TKeyBoardModeTrackerr.DoKeyDown, 
TKeyBoardModeTrackerr.DoSetFocus . . . 

TEventHandler-TEqualOperatortype eventhan.h 

A nested class, TequalOperator is used to perform special kinds of searches 
and to faciliate finding response table entries. TEqualOperator compares a 
particular message event (TEventInfo&) with a response table entry 
(TGenericTableEntry) to determine if they match. 
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TEventHandler::TEqualOperator type 



typedef BOOL(*TEqualOperator) (TGenericTableEntry _RTFAR&, TEventInfo&) ; 
See also: TResponseTableEntry 



TFileDocument class 



filedoc.h 



Derived from TDocument, TFileDocument opens and closes views and 
provides stream support for views. Streams are created on top of DOS files 
using Windows file services. TFileDocument has member functions that 
continue to process FileNew and FileOpen messages after a view is 
constructed. You can add support for specialized file types by deriving 
classes from TFileDocument. TFileDocument makes this process easy by 
hiding the actual processs of storing file types. 



Constructor 



Destructor 



Public constructors and destructor 



TFileDocument (TDocument* parent = 0)'; 

Constructs a TFileDocument object with the optional parent document. 

-TFileDocument () 

Destroys a TFileDocument object. 



Public member functions 



Close 



Commit 



FindProperty 



inline BOOL Close () ; 

Closes the document but does not delete or detach any associated views. 
Before closing the document, Close calls TDocument's Close to make sure all 
child documents are closed. If any children are open, Close returns and 
doesn't close the document. If all children are closed, checks to see if any 
associated streams are open, and if so, returns and doesn't close the 
document. If there are no open streams, closes the file. 

See also: TDocument: -.Close 

BOOL Commit (BOOL clear .= FALSE); - 

Calls TDocument -.-.Commit and clears TDocument's DirtyFlag data member, 
thus indicating that there are no unsaved changes made to the document. 

See also: TDocumentr.Commit 

int* FindProperty (const char far* name); 
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InStream 



FindProperty gets the property index, given the property name (name). 
Returns if the name isn't found. 

See also: pfxxxx property attribute constants 

GetProperty GetProperty(int index, void far* dest, int textlen=0); 

Overrides TDocument::GetProperty and gets the property ID for the current 
file document. 

See also: pfxxxx property attribute constants 

TInStream* InStream (int mode, LPCSTR strmld = 0); 

Overrides Tdocument::InStream and provides generic input for the particular 
storage medium. InStream returns a pointer to a TInStream. mode is a 
combination of the ios bits defined in iostream.h. strmld is not used for file 
documents. The view reads data from the document as a stream or through 
stream functions. 

See also: TFileDocumentr.OutStream 

inline BOOL IsOpenO ; 

Is nonzero if the document or any streams are open. 

inline BOOL Open(HFILE fhdl); 

Opens a file document using an existing file handle. Sets 

TDocument: :OpenMode to PREV_OPEN and read/write. Sets the document 

path to 0. Sets FHd to fhdl. Always returns nonzero. 

inline BOOL Open(int mode, LPCSTR path=0); 

Overrides TDocument:: Open and opens the file using the specified path. If 
the file is already open, returns 0. Calls TDocumentr.SetDocPath to set the 
directory path. If omode isn't 0, sets TDocument r.OpenMode to omode. If the 
file can't be opened, returns 0. 

See also: TDocument::DocPath, TDocumentr.Open, ofxxxx document open 
enum 

inline TOutStream* OutStream (int mode, LPCSTR strmld = 0); 

Overrides TDocumentr.OutStream and provides generic input for the 
particular storage medium. OutStream returns a pointer to a TOutStream. 
mode is a combination of the ios bits defined in iostream.h. strmld is not 
used for file documents. Instead, the view reads data from the document 
through stream functions. 

See also: TFileDocumentr.InStream 

PropertyFlags i nt PropertyFlags(int index); 



IsOpen 
Open 

Open 



OutStream 
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rFileDocument class 



PropertyName 



Revert 



SetProperty 



Returns the property attribute constants (pfGetText, pfHidden, and so on). 
See also: pfxxxx property attribute constants 

const char* PropertyName ( int index); 

Returns the text name of the property given the index value. 

See also: pfxxxx property attribute constants 

BOOL Revert (BOOL clear = FALSE); 

Calls TDocument: -.Revert to notify the views to refresh their data. If clear is 
FALSE, the data is restored instead of cleared. 

See also: TFileDoc::Commit 

BOOL SetProperty (int index, const void far* src); 

Sets the property data, which must be in the native data type (either string 
or binary). 

See also: pfxxxx property attribute constants 



Protected data members 



FHdl 



HFILE FHdl; 

Holds the file handle to an open file document. 



Protected member functions 



ClOSeThisFile void CloseThisFile(HFILE fhdl, into omode) ; 

If the associated file was opened by TFileDocument, CloseThisFile closes the 
file handle. Calls TDocument::NotifyView to notify all views that the file 
document has closed. 

See also: ofxxxx document open enum 

OpenThisFile HFILE OpenThisFile(int omode, LPCSTR name, streampos* pseekpos) ; 

Opens the file document after checking the file sharing mode (omode). If a 
file mode is not specified as read, write, or read and write, returns Q. 

See also: ofxxxx document open enum, shxxxx document sharing modes 
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TFileOpenDialog class 



TFileOpenDialog class 



opensave.h 



Constructor 



TFileOpenDialog is a modal dialog box that lets you specify the name of a 
file to open. 

Public constructors 

TFileOpenDialog (TWindow* parent, TData& data, TResID templatelD = 0, 

const char far* title = 0, TModule* module =0); - 

Constructs and initializes the TFileOpen object based on information in the 
TOpenSaveDialogr.TData data structure. The Windows API 
OPENFILENAME structure is also initialized. 

See also: TOpenSaveDialogr.TData 



DoExecute 



Public member functions 



int DoExecute ' 



DoExecute calls the Windows API function GetOpenFileName and passes it 
the Windows API OPENFILENAME structure, which tells it how to create 
the TFileOpenDialog object. 

See also: TDialog: -.DoExecute 



TFileSaveDialog class 



opensave.h 



Constructor 



TFileSaveDialog is a modal dialog that lets you enter the name of a file to 
save. 

Public constructors 

TFileSaveDialog (TWindow* parent, TData& data, TResID templatelD = 0, 
const char far* title = 0, TModule* module = 0); 

Constructs and initializes the TFileOpen object based on information in the 
TOpenSaveDialog::TData data structure. 
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TFileSaveDialog class 



DoExecute 



Public member functions 



int DoExecute i 



DoExecute calls the Windows API function GetOpenFileName and passes it 
the OPENFILENAME structure, which tells GetOpenFileName how to create 
the TFileSaveDialog object. 

See also: TDialog: -.DoExecute, TOpenSaveDialog 



TFilterValidator class 



validate.h 



A streamable class, TFilterValidator checks an input field as the user types 
into it. The validator holds a set of allowed characters. When the user 
enters a character, the filter validator indicates whether the character is 
valid or invalid. See TValidator for an example of input validation. 

Public constructors 



Constructor 



Error 



IsValid 



IsValidlnput 



TFilterValidator (const TCharSetk validChars); 

Constructs a filter validator object by first calling the constructor inherited 
from TValidator, then setting ValidChars to validChars. 

Public member functions 

void Error ( ) ; 

Error overrides TValidator's virtual function and displays a message box 
indicating that the text string contains an invalid character. 

See also: TValidator: -.Error 

BOOL IsValid(const char far* str) ; - 

IsValid overrides TValidator's virtuals and returns TRUE if all characters in 
str are in the set of allowed characters, ValidChar; otherwise, it returns 
FALSE. 

BOOL IsValidlnput (char far* str, BOOL suppressFill) ; 

IsValidlnput overrides TValidator's virtual function and checks each 
character in the string str to ensure it is in the set of allowed characters, 
ValidChar. IsValidlnput returns TRUE if all characters in str are valid; 
otherwise, it returns FALSE. 
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See also: TValidatorr.IsValidlnput 



Protected data members 



ValidChars 



TCharSet ValidChars; 

Contains the set of all characters the user can type. For example, to allow 
only numeric digits, set ValidChars to "0-9". ValidChars is set by the 
validChars parameter passed to the constructor. 



TFindDialog class 



findrepl.h 



Constructor 



TFindDialog objects represents modeless dialog box interface elements that 
let you specify text to find. TFindDialog communicates with the owner 
window using a registered message. 

Public constructors 

TFindDialog (TWindow* parent, TData& data, TResId templateld = 0, 
const char far* title = 0, TModule* module = 0); 

Constructs a TFindDialog object with the given parent window, resource ID, 
and caption. Sets the attributes of the dialog box based on information in 
the TFindReplaceDialog: :TData structure. 

See also: TFindReplaceDialogr.TData 



Protected member functions 



DoCreate 



HWND DoCreateO; 

Creates the modeless interface element of a find dialog box. 



TFindReplaceDialog class 



findrepl.h 



TFindReplaceDialog is an abstract base class for a modeless dialog box that 
lets you search for and replace text. TFindReplaceDialog communicates with 
the owner window using a registered message. 
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TFindReplaceDialog class 



Public constructors 



Constructor 



CmCancel 

CmFindNext 

CmReplace 

CmReplaceAII 

EvNCDestroy 



Data 



fr 



TFindReplaceDialog (TWindow* parent, TData& data, TResId templateld. = 0, 
const char far* title = 0, TModule* module = 0) ; 

Constructs a TFindReplaceDialog object with a parent window, resource ID, 
and caption. Sets the attributes of the dialog box with the specified data. 



See also: TFindReplaceDialog: :TData 



Public member functions 



inline void CmCancel (); 

Responds to a click of the Cancel button. 

inline void CmFindNext () ; 

Responds to a click of the Find Next button. 

inline void CmReplace (); 

Responds to a click of the Replace button. 

inline void CmReplaceAII () ; 

Responds to a click of the Replace All button. 

inline void EvNCDestroy () ; 

Calls TWindozv::EvNCDestroy, which responds to an incoming 
EV_WM_NCDESTROY message. 



See also: TWindowr.EvNCDestroy 



Protected data members 



TData& Data; 

Data is a reference to the TData object passed in the constructor. 

See also: TFindReplacer.TData 

FINDREPLACE fr; 

Contains find-and-replace attributes such as the text string to be searched 
for and replaced as well as the length of the string that ObjectWindows 
passes to the Windows API FindText function. Returns an error message if 
text is not found. 
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Protected member functions 



DoCreate 



DialogFunction 



Init 



HWND DoCreate ()=0; 

DoCreate is a virtual function that is overriden in derived classes to create a 
modeless find or replace dialog box. 

BOOL DialogFunction (UINT message, WPARAM, LPARAM) ; 

Returns TRUE if a message is handled. 

See also: TDialogr.DialogFunction 

void Init (TResId templateld) ; 

Used by constructors in derived classes, Init initializes a TFindReplaceDialog 
object with the current resource ID and other members. 



Response table entries 



Response table entry 



Member function 



EV WM NCDESTROY 



EvNCDestroy 



TFindReplaceDialog::TData struct 



findrepl.h 



The TFindReplaceDialog: :TData structure defines information necessary to 
initialize a TFindReplace dialog box. 

Public member functions 



BuffSize 



Error 



int BuffSize; 

BuffSize contains the size of the text buffer. 

DWORD Error; 

Error contains one or more of the following CommDlgExtendedError codes: 



Constant 



Meaning 



CBERR_LOCKRESOURCEFAILURE 
CDERR LOADRESFAILURE 



Failed to lock a specified resource. 
Failed to load a specified resource. 
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TFindReplaceDialog: :TData struct 



Constant 



Meaning 



FindWhat 



Flags 



Replacewith 



CDERRJ.OADSTRFAILURE 
CDERR REGISTERMSGFAIL 



Failed to load a specified string. 

The Windows API RegisterWindowMessage 

function returned an error when it was called. 



char* FindWhat; 

FindWhat contains the search string. 

DWORD Flags; 

Flags indicates the state of the control buttons and the action that occurred 
in the dialog box, and can be a combination of the following Window API 
constants: 



Constant 



Meaning 



FR_DOWN 

FR_HIDEMATCHCASE 

FRJHIDEWHOLEWORD 

FR_HIDEUPDOWN. 

FR_MATCHCASE 

FR_NOMATCHCASE 

FR_NOUPDOWN 

FR_NOWHOLEWORD 

FR_REPLACE 
FR_REPLACEALL 
FR WHOLEWORD 



The Down button in the Direction group of the Find dialog box is 

selected. 

The Match Case check box is hidden. 

The Whole Word check box is hidden. 

The Up and Down buttons are hidden. 

The Match Case check box is checked. 

The Match Case check box is disabled. This occurs when the 

dialog box is first initialized. 

The Up and Down buttons are disabled. This occurs when the 

dialog box is first initialized. 

The Whole Word check box is disabled. This occurs when the 

dialog box is first initialized. 

The Replace button was pressed in the Replace dialog box. 

The Replace All button was pressed in the Replace dialog box. 

The Whole Word check box is checked. 



char* ReplaceWith; 

ReplaceWith contains the replacement string. 

See also: TEditSearch::SearchData, TFindReplace::Data 



TFIoatingFrame class 



fioatfra.h 



Derived from TFrameWindow and TTinyCaption, TFIoatingFrame implements 
a floating frame that can be positioned anywhere in the parent window. 
Except for the addition of a tiny caption bar, the default behavior of 
TFrameWindow and TFIoatingFrame is the same. Therefore, an application 
that uses TFrameWindow can easily gain the functionality of TFIoatingFrame 
by just changing the name of the class to TFIoatingFrame. 
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If there is a client window, the floating frame shrinks to fit the client 
window, leaving room for margins on the top, bottom, left, and right of the 
frame. Because the floating frame expects the client window to paint its 
own background, it does nothing in response to a WMJERASEBKGND 
message. However, if there is no client window, the floating frame erases 
the client area background using COLORJ3TNFACE. 

See PAINT.CPP, the sample program on your distribution disk, for an 
example of a floating frame. 

Public constructors 

Constructor TFIoatingFrame (Window *owner, char *title = 0, Window* clientWnd- =. 0, 

BOOL shrinkToClient = FALSE, int CaptionHeight, BOOL 
enablePalette, Module* module = 0); 

Constructs a TFIoatingFrame object attached to the specified parent window. 
By default, the floating frame window doesn't shrink to fit the client 
window, and the floating palette style isn't enabled. 

Set enablePalette to TRUE if you want to enable a floating palette style for 
the window. The floating palette is a popup window with a tiny caption, a 
standard window border, and a close box instead of a system menu box. 
There are no maximize or minimize buttons. A one pixel border is added 
around the client area in case a toolbox is implemented. This style must be 
turned on before the window is created. After the window is created, its 
style can't be changed. 

See also: TFrameWindow::TFrameWindow, TTiny Caption: :TTiny Caption 

Public member functions 

SetMargins vo i& SetMargins (const TSize& margin); 

Sets the margins of the floating palette window to the size specified in 
margin and sets the height of the tiny caption bar. 

See also: TTiny Caption: :EnableTiny Caption 
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TFIoatingFrame class 



Response table entries 



Response table entry 



Member function 



EV_WM_SYSCOMMAND 
EV_WM_NCCALCSIZE 
EV WM NCPAINT 



EvSysCommand 

EvNCCalcSize 

EvNCPaint 



TFont class 



gdiobjec.h 



enum TStockld 



TFont derived from TGdiObject provides constructors for creating font 
objects from explicit information or indirectly. 

Public data members 

enum TStockId{AnsiPixed, AnsiVar, DeviceDefault, OemFixed, System, 
SystemFixed} ; 

Enumerates the stock fonts. 

See also: TGdiObject::Stocks[] 

Protected data members 



Stocks[ ] 

Note: This array no 

longer exists. Use 

TDC::SelectStockObject 

instead. 



static TFont Stocks []■; 

The single static array of Windows stock fonts serving all TFont objects. The 
stock fonts are ANSI_FIXED_FONT, ANSI_VAR_POINT, 
DEVICE_DEFAULT_FONT, OEM_FIXED_FONT, SYSTEM_FONT, and 
SYSTEM_FIXED_FONT. 

See also: enum TStockld 



Public constructors 

Constructor TFont (HFONT handle, TAutoDelete autoDelete = NoAutoDelete) ; 

Creates a TFont object and sets the Handle data member to the given 
borrowed handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle will not be deleted when the C++ object 
is destroyed. 

See also: TGdiObject::Handle, TGdiObject:: ShouldDelete 
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Constructor 



Constructor 



TFont (const char far* facename = 0, int height = 0, int width = 0, 

int escapement = 0, int orientation = 0, int weight = FW_NORMAL, 
BYTE pitchAndFamily = DEFAULT_PITCH|FF_DONTCARE, BYTE italic 
= FALSE, BYTE underline = FALSE, BYTE strikeout = FALSE, 
BYTE charSet = 1, BYTE outputPrecision = OUT_DEFAULT_PRECIS, 
BYTE clipPrecision = CLIP_DEFAULT_PRECIS, BYTE quality 
= DEFAULT_QUALITY) ; 

Creates a TFont object with the given values. Sets Handle via a Win API 
CreateFont call with the given default values. 

See also: ::CreateFont 

TFont (const LOGFONT far* logFont); 

Creates a TFont object from the given logFont. Sets Handle via a WinAPI 
CreateFontlndirect(logFont) call. 

See also: ::CreateFontIndirect 



Public member functions 



GetObject 



GetStock 



operator HFONT() 



inline BOOL GetObject (LOGFONT far& logFont) const; 

Retrieves information about this pen object and places it in the given 
LOGFONT structure. Returns TRUE if successful and FALSE if 
unsuccessful. 

See also: TGdiObject::GetObject, struct LOGFONT 

static TFont& GetStock (TStockld id) ; 

Provides access to stock Windows font objects. Returns TFont::Stocks[id]. 

See also: enum TStockld 

inline operator HF0NT() const; ' 

Typecasting operator that converts this font's Handle to type HFONT (the 
Windows data type representing the handle to a physical font). 



TFrameWindow class 



framewin.h 



Derived from TWindow, TFrameWindow controls such window-specific 
behavior as keyboard navigation and command processing for client 
windows. For example, when a window is reactivated, TFrameWindow is 
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TFrameWindow class 



responsible for restoring a window's input focus and for adding menu bar 
and icon support. TFrameWindow is a streamable class. 

See TFloatingFrame for a description of a floating frame with the same 
default functionality as a frame window. 

Public data member 

KeyboardHandling bool KeyboardHandiing; 

Indicates if keyboard navigation is required. 

Public constructors and destructor 



Constructor 



Constructor 



Destructor 



TFrameWindow (TWindow* parent, const char far *title = 0, 

TWindow *clientWnd = 0, BOOL shrinkToClient = FALSE, 
TModule* module = 0) ; 

Constructs a window object with the parent window supplied in parent. 
Sets the position and extent fields of Attr structure to defaults appropriate 
for overlapped and pop-up windows. 

See also: TWindow ::T Window, TFloatingFrame: -.TFloatingFrame 

TFrameWindow (HWND hWnd, TModule* module = 0); 

Constructor for a TFrameWindow that is being used as an alias for a 
non-ObjectWindows window. 

-TFrameWindow; 

Deletes any associated menu descriptor. 



Public member functions 



AssignMenu 



EnableKBHandler 



virtual BOOL AssignMenu (TResId menuResId) ; 

Sets Attr.Menu to the supplied menuResId and frees any previous strings 
pointed to by Attr.Menu. If H Window is nonzero, loads and sets the menu of 
the window, destroying any previously existing menu. 

See also: TMDIFrame:: AssignMenu, TFrameWindow r.SetMenu 

void EnableKBHandler (); 

Sets a flag indicating that the receiver has requested keyboard navigation 
(translation of keyboard input into control selections). By default, the 
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GetClientWindow 



GetMenuDescr 



HoldFocusHwnd 



IdleAction 



MergeMenu 



PreProcessMsg 



RestoreMenu 



SetClientWindow 



keyboard interface, which lets users use the tab and arrow keys to move 
between the controls, is disabled for windows and dialog boxes. 

inline virtual TWindow *GetClientWindow() ; 

Returns a pointer to the client window. 

See also: TMDIClient: -.GetClientWindow 

inline const TMenuDescr* GetMenuDescr () ; 

Returns a pointer to the menu descriptor. 

See also: TFrameWindow ::SetMenuDescr 

virtual BOOL HoldFocusHWnd(HWND hWndLose, HWND hWndGain) ; 

Responds to a request by a child window to hold its HWND when it is 
losing focus. Stores the child's HWND in HwndRestoreFocus. 

See also: TWindow: -.HoldFocusHwnd 

void IdleAction () ; 

T Application calls the main window's IdleAction when no messages are 
waiting to be processed. TFrameWindow uses this idle time to perform 
command enabling for the menu bar. It also forwards IdleAction to each of 
its children. IdleAction can be overridden to do background processing. 

See also: T Application: -.Idle Action 

BOOL MergeMenu (const TMenuDescr& childMenuDescr) ; , 

Merges the given menu descriptor with this frame's own menu descriptor 
and displays the resulting menu in this frame. See TMenuDescr for a 
description of menu bar types that can be merged. 

See also: TMenuDescr class 

BOOL PreProcessMsg (MSG& msg) ; 

Performs preprocessing of window messages. If the child window has 
requested keyboard navigation, PreProcessMsg handles any accelerator key 
messages and then calls the Windows API function r.IsDialogMessage to 
process any other keyboard messages. 

See also: TWindow: -.PreProcessMsg 

BOOL RestoreMenu () ; 

Restores the default menu of the frame window. 

virtual TWindow * SetClientWindow (TWindow* clientWindow) ; 
Sets the client window to the specified window. 
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Setlcon BOOL SetlconfTInstance iconlnst, TResId iconResId) ; 

Sets the icon to the specified resource ID. 

See also: TFrameWindow: :EvQueryDragIcon 
SetMenuDescr yo^ setMenuDescr (const TMenuDescrk menuDescr) ; 

Sets the menu descriptor to the new menu descriptor. 

See also: TFrameWindow::GetMenuDescr 

Protected data members 



ClientWnd TWindow *ClientWnd; 

ClientWnd points to the frame's client window. 
DocTitlelndex i nt DocTi tie Index; 

Holds the index number for the document title. 
HWndRestoreFocuS HWND HWndRestoreFocus; 

Stores the handle of the child window whose focus gets restored. 

See also: TFrameWindow::HoldFocusHwnd 



Protected member functions 



EvCommand LRESULT EvCommand(UINT id, HWND hWndCtl, UINT notifyCode) ; 

Provides extra processing for commands and lets the focus window and its 
parent windows handle the command first. > ■ 

EvCommandEnable void EvCoimandEnable(TConunandEnabler& ce) ; 

Handles checking and unchecking of the frame window's menu items. 

See also: TMenuItemEnabler::TCommandEnabler 

EvEraseBkgnd BOOL EvEraseBkgnd (HDC); 

EvEraseBkgnd erases the background of the window specified in HDC. It 
returns TRUE if the background is erased; otherwise, it returns FALSE. 

EvInitMehuPopup HANDLE EvInitMenuPopup(HMENU hPopupMenu, UINT index, BOOL sysMenu) ; 

Sent before a pop-up menu is displayed, EvInitMenuPopup lets an 
application change the items on the menu before the menu is displayed. 
EvInitMenuPopup controls whether the items on the pop-up menu are 
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EvPaint 



EvParentNotify 



EvQueryDraglcon 



EvSetFocus 



EvSize 



SetupWindow 



enabled or disabled, checked or unchecked, or strings. HMENU indicates 
the menu handle, index is the index of the pop-up menu. sysMenu indicates 
if the pop-up menu is the system menu. 

See also: ::WM_INITMENUPOPUP 

void EvPaint ( ) ; 

Responds to a WM_PAINT message in order to paint the iconic window's 
icon or to allow client windows a chance to paint the icon. 

See also: TWindozv::EvPaint, TWindowr.Paint, T Scroller r.BeginView, 
T Scroller y.EndView 

void EvParentNotify (UINT event, UINT childHandleOrX, UINT childlDOrY) ; ' 

Responds to a message to notify the parent window that a given event has 
occurred. If the client window is destroyed, closes the parent window. If 
shrinkToClient is set and the child window has changed size, the frame is 
adjusted. 

HANDLE EvQueryDraglcon () ; 

Responds to a Windows API WM_QUERYDRAGICON message sent to a 
minimized (iconic) window that is going to be dragged. Instead of the 
default Windows icon, EvQueryDraglcon uses the icon that was set using 

Setlcon. 

See also: TFrameWindow::SetIcon, ::WM_QUERYDRAGICON 

void EvSetFocus (HWND hWndLostFocus); 

Restores the focus to the active window. If the object is an alias, EvSetFocus 
calls TWindow:: Activate. hWndLostFocus contains the handle to the window 
that lost the focus. 

See also: TWindow::Ev Activate, ::WM_SETFOCUS 

void EvSize (UINT sizeType, TSize &size) ; 

Resizes the client window's size so that it is equivalent to the client 
rectangle's size. Calls TWindowr.EvSize in response to an incoming 
Windows API WM_SIZE message. 

See also: TWindow::EvSize 

void SetupWindow () ; 

Calls Twindowr.SetUpWindozv to create windows in a child list. SetupWindow 
performs the initial adjustment of the client window if one exists, assigns 
the frame's menu based on the menu descriptor, and initializes 
HwndRestoreFocus. 
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TFrameWindow class 



See also: TWindow::SetUpWindow 



Response table entries 



Response table entry 



Member function 



EV_WM_ERASEBKGND 

EV_WM_INITMENUPOPUP 

EV_WM_PAINT 

EV_WM_PARENTNOTIFY 

EV_WM_QUERYDRAGICON 

EV_WM_SETFOCUS 

EV WM SIZE 



EvEraseBkgnd 

EvWmlnitMenuPopup 

EvPaint 

EvParentNotify 

EvQueryDraglcon 

EvWmSetFocus 

EvWmSize 



TGadget class 



gadget.h 



TGadget is the base class for the derived classes — TBitmapGadget, 
TButtonGadget, TControlGadget, TTextGadget, and TSeparatorGadget. TGadget 
interface objects belong to a gadget window, have borders and margins, 
and have their own coordinate system. The margins are the same as those 
for TGadgetWindow and borders are always measured in border units. 

To set the attributes for the gadget, you can either choose a border style 
(which automatically sets the individual border edges) or set the borders 
and then override the member function PaintBorder to create a custom look 
for your gadget. If you change the borders, margins, or border style, the 
gadget window's GadgetChangedSize member function is invoked. 

Although, by default, gadgets shrink-wrap to fit around their contents, you 
can control this attribute by setting your own values for ShrinkWrapWidth 
and ShrinkWrapHeight. 

Public data members 



Clip BOOL Clip; 

If Clip is FALSE, clipping borders have not been established. If Clip is 
TRUE, the drawing for each gadget is restrained by the gadget's border. 

TBorders struct TBorders structure holds the values for the left, right, top, and bottom 

measurements of the gadget. 
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TBorderStyle 
enum 



TMargins struct 



WideAsPossible 



struct TBorders 
unsigned Left; 
unsigned Right; 
unsigned Top; 
unsigned Bottom; 

enum TBorderStyle; 

Enumerates border styles as either none, plain, raised, recessed, or 
embossed. For an example of border styles, see the sample ObjectWindows 
program, MDIFILE.CPP, on your distribution disk. 

Used by the TGadgetWindow and TGadget classes, TMargins contains the 
measurements of the margins for the gadget. The constructor initializes 
Units to LayoutUnits and sets Left, Right, Top, and Bottom equal to 0. 

struct TMargins { 

enum TUnits (Pixels, LayoutUnits, BorderUnits}; 

TUnits Units; 

int Left; 

int Right ; 

int Top; 

int Bottom; 

See also: TGadgetWindow: -.SetMargins 

BOOL WideAsPossible; 

Initially set to FALSE, WideAsPossible indicates whether the gadget width 
will be adjusted by the gadget window to be as wide as possible in the 
remaining space. 

See also: TGadgetWindow: -.WideAsPossible 



Public constructors and destructor 



Constructor TGadget (int id =0, TBorderStyle = None); 

Constructs a. TGadget object with the specified ID and border style. 

Destructor virtual -TGadget (); 

Destroys a TGadget interface object and removes it from its associated 
window. 
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TGadget class 



Public member functions 



CommandEnable 



GetBorders 



GetBorderStyle 



GetBounds 



GetDesiredSize 



GetEnabled 



Getld 



GetMargins 



virtual void CommandEnable () ; 

CommandEnable is provided so that the gadget can perform command 
enabling (so it can handle an incoming message, if it's appropriate to do so). 

inline TBordefs &GetBorders ( ) ; 

Gets the gadget's borders measured in border units that are based on 
SM_CXBORDER and SM_CYBORDER. 

See also: TGadget ::SetBorders 

inline TBorderStyle GetBorderStyle () ; 

Gets the style for the gadget's borders. 
See also: TGadgetr.SetBorderSfyle 

inline TRect &GetBounds ( ) ; 

Returns the boundary rectangle for the gadget. 

See also: TButtonGadget::SetNotchCorners 

virtual void GetDesiredSize (TSize& size); 

GetDesiredSize determines how big the gadget can be. The gadget window 
sends this message to query the gadget's size. If shrink-wrapping is 
requested, GetDesiredSize returns the size needed to accommodate the 
borders and margins. If shrink-wrapping is not requested, it returns the 
gadget's current width and height. TGadgetWindow needs this information 
to determine how big the gadget needs to be, but it can adjust these 
dimensions if necessary. If WideAsPossible is TRUE, then the width 
parameter (size.cx) is ignored. 

inline BOOL GetEnabled (); 

Determines whether keyboard and mouse input have been enabled for the 
specified gadget. If the gadget is enabled, GetEnabled returns TRUE; 
otherwise, it returns FALSE. By default, keyboard and mouse input are 
enabled. 

See also: TGadget ::SetEnabled 

inline int Getld () ; ' 

Gets the ID for the gadget. 
inline TMargins &GetMargins ( ) ; 
Gets the margin dimensions. 
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GetOuterSizes 

NextGadget 
SetBorders 



SetBorderStyle 



SetBounds 



SetEnabled 



SetMargins 



SetShrinkWrap 



SetSize 



void GetOuterSizes (int& left, int& right, int& top, int& bottom); 

Returns the amount of space (in pixels) taken up by the borders and 
margins. 

inline TGadget *NextGadget ( ) ; 

Returns the next gadget in the list of gadgets. 

void SetBorders (TBorders& borders) ; 

Sets the borders for the gadget. If the borders are changed, SetBorders calls 
TGadgetWindow/.GadgetChangedSize to notify the gadget window of the 
change. 

See also: TGadget ::GetBorders, TGadgetWindow::GadgetChangedSize 

void SetBorderStyle (TBorderStyle) ; 

Sets the border style for the gadget. 

See also: TGadget ::GetBorder Style 

virtual void SetBounds (TRect& rect); 

SetBounds informs the gadget of a change in its bounding rectangle. 
Although the default behavior updates only the instance variable Bounds, 
you can override this method to also update the internal state of the gadget. 

virtual void SetEnabled (BOOL); 

Enables or disables keyboard and mouse input for the gadget. By default, 
the gadget is disabled when it is created and must be enabled before it can 
be activated. 

See also: TGadget ::GetEnabled 

void SetMargins (TMarginsk margins); 

Sets the margins of the gadget. If the margins are changed, SetMargins calls 
TGadgetWindow::GadgetChangedSize to notify the gadget window. 

See also: TGadget ::GetMar gins 

void SetShrinkWrap (BOOL shrinkWrapWidth, BOOL shrinkWrapHeight) ; 

Sets the ShrinkWrapWidth and ShrinkWrapHeight data members. Your 
derived class can call TGadgetWindow's GadgetChangedSize member function 
if you want to change the size of the gadget. 

See also: TGadgetWindowr.GadgetChangedSize 

void SetSize (TSize& size) ;- 
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I (iadget class 



SetSize alters the size of the gadget and then calls 

TGadget Window: :Gadget,ChangedSize. for the size change to take effect. 

This function is needed only if you have turned off shrink-wrapping in one 
or both dimensions; otherwise, use the GetDesiredSize member function to 
return the shrink-wrapped size. 



SysColorChange virtual void SysColorChange I 



SysColorChange is called when the system colors have been changed so that 
gadgets can rebuild and repaint, if necessary. 

Protected data members 



Bounds 



BorderStyle 
Borders 

Id 
Margins 

ShrinkWrapHeight 

ShrinkWrapWidth 

TrackMouse 



TRect Bounds; 

Contains the bounding rectangle for the gadget in gadget window 
coordinates. 

See also: TGadget ::GetInnerRect . 

TBorderStyle BorderStyle; 

Contains the border style for the gadget. 

TBorders Borders; 

Contains the border measurements for the gadget. 

See also: TGadgetr.GetlnnerRect 

int Id; 

Contains the gadget's ID. 

TMargins Margins; 

Contains the margin measurements of the rectangle. 

See also: TGadgetr.GetlnnerRect 

BOOL ShrinkWrapHeight; 

Indicates if the gadget is to be shrink-wrapped to fit around its contents. 

BOOL ShrinkWrapWidth; 

Indicates if the gadget is to be shrink-wrapped to fit around its contents. 

BOOL TrackMouse; 
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Window 



Initialized to FALSE. When TrackMouse is TRUE, the gadget captures and 
releases the mouse on LButtonDown and LButtonllp by calling 
TGadgetWindow's Gadget SetCapture and GadgetReleaseCapture. 

See also: TGadget::LButtonDozvn, TGadget::LButtonlIp 

TGadgetWindow *Window; 

References the owning or parent window for the gadget. 



Protected member functions 



GetlnnerRect 



Inserted 



Invalidate 



InvalidateRect 



LButtonDown 



LButtonUp 



MouseEnter 



MouseLeave 



void GetlnnerRect (TRect& rect); 

Computes the area of the gadget's rectangle excluding the borders and 
margins. 

virtual void InsertedO; 

Called after a gadget is inserted into a window. 

void Invalidate ('BOOL erase = TRUE); 

Used to invalidate the active (usually nonborder) portion of the gadget, 
Invalidate calls InvalidateRect and passes the boundary width and height of 
the area to erase. 

void InvalidateRect (const TRect& rect, BOOL erase = TRUE); 

Invalidates the gadget-relative rectangle in the parent window. 

virtual void LButtonDown (UINT modKeys, TPointk point); 

Captures the mouse if TrackMouse is set. point is located in the gadget's 
coordinate system. 

See also: TGadget "TrackMouse 

virtual void LButtonUp (UINT modKeys, TPoint& point); 

Releases the mouse capture if TrackMouse is set. point is located in the 
gadget's coordinate system. 

See also: TGadget -.-.TrackMouse 

virtual void MouseEnter (UINT modKeys, TPointk point); 
Called when the mouse enters the gadget. 
See also: TGadget: -.MouseLeave 

virtual void MouseLeave (UINT modKeys, TPoint& point); 



Chapter i, Library reference 



213 



TGadget class 



MouseMove 



Paint 



PaintBorder 



Ptln 



Removed 



Called when the mouse leaves the gadget. 
See also: TGadget ::MouseEnter 

virtual void MouseMove (UINT modKeys, TPoint& point); 

If mouse events are captured, EvMouseMove responds to a mouse dragging 
message, point is located in the receiver's coordinate system. 

See also: TGadget ::MouseEnter, TGadget ::MouseLeave 

virtual void Paint (TDC&) ; 

Calls PaintBorder to paint the indicated device context. 

See: TTextGadgetr.Paint 

virtual void PaintBorder (TDC& dc) ; 

Used to paint the border, PaintBorder calls ::GetSystemMetrics to obtain the 
width and height of the gadget and uses the color returned by GetSyscolor 
to paint or highlight the area with the specified brush. Depending on 
whether the border style is raised, embossed, or recessed, PaintBorder 
paints the specified boundary. You can override this function if you want to 
implement a border style that isn't supported by ObjectWindows's gadgets. 

virtual BOOL PtIn(TPoint& point); 

Ptln determines if the point is within the receiver's bounding rectangle and 
returns TRUE if this is the case; otherwise, returns FALSE. 

virtual void Removed (); 

Called after a gadget is removed from a window. 



TGadgetWindow class 



gadgetwi.h 



Derived from T Window, TGadgetWindow maintains a list of tiled gadgets for 
a window and lets you dynamically arrange tool bars. You can specify the 
following attributes of these gadgets: 

■ Horizontal or vertical tiling. Positions the gadgets horizontally or 
vertically within the inner rectangle (the area excluding borders and 
margins). 

■ Gadget font. Default font to use for gadgets and for calculating layout 
units. For font information, see the description of TGadgetFont. 

■ Left, right, top, and bottom margins. Specified in pixels, layout units 
(based on the window font), or border units (the width or height of a thin 
window border). 
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■ Measurement units. Specified in pixels, layout units, or border units. 

■ Gadget window size. A gadget window can shrink-wrap its width, 
height, or both to fit around its gadgets. By default, horizontally tiled 
gadgets shrink-wrap to fit the height of the window and vertically tiled 
gadgets shrink-wrap to fit the width of the window. 

TGadgetWindow is the base class for the following derived classes: 
TControlBar, TMessageBar, TToolBox, and TStatusBar. 

Public constructors and destructor 



Constructor 



Destructor 



TGadgetWindow (TWindow *parent = 0, TTileDirection direction = Horizontal, 
TFont *font = new TGadgetWindowFont , TModule* module = 0) ; 

Creates a TGadgetWindow interface object with the default tile direction and 
font and passes module with a default value of 0. 

-TGadgetWindow! ); 

Destructs the TGadgetWindow object by deleting all of its gadgets and fonts. 



Public member functions 



FirstGadget inline TGadget* FirstGadget () const; 

Returns the FirstGadget in the list. 

See also: TGadgetWindow::FirstGadget 

GadgetChangedSize vo id GadgetChangedSize (TGadget& gadget); 

Used to notify the gadget window that a gadget has changed its size, 
GadgetChangedSize calls LayoutSession to re-layout all gadgets. 

See also: TGadgetr.SetShrinkWrap, TGadgetWindow::GadgetChangedSize 
GadgetFromPoint TGadget* GadgetFromPoint(TPoint& point); 

Returns the gadget at the given window coordinates. 
GadgetReleaseCapture void GadgetReleaseCapture(TGadget& gadget); 

Releases the capture so that other windows can receive mouse messages. 

See also: TGadgetWindowr.GadgetSetCapture 
GadgetSetCapture B 00L GadgetSetCapture(TGadget& gadget); 
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GadgetWithld 



GetDirection 



GetFont 



GetFontHeight 



GetHintMode 



IdleAction 



Insert 



LayoutSession 



GadgetSetCapture reserves all mouse messages for the gadget window until 
the capture is released. Although gadgets are always notified if a left 
button-down event occurs within the rectangle, the derived gadget class 
must call GadgetSetCapture if you want the gadget to be notified when a 
mouse drag and a mouse button-up event occurs. 

See also: TGadgetWindow::GadgetReleaseCapture 

TGadget *GadgetWithId(int id) const; 

Returns a pointer to the gadget associated with the given ID (id). 

inline TTileDirection GetDirection () const; 

Gets the horizontal or vertical orientation of the gadgets. 

See also: TGadgetWindow: :SetDirection 

inline TFont &GetFont(); 

Returns the font (which is MS Sans Serif by default). 

See also: TGadgetWindowFontr.TGadgetWindowFont 

inline UINT GetFontHeight ( ) const; 

Gets the height of the window's font. 

inline THintMode GetHintMode () ; 

Returns the hint mode. 

void IdleAction () ; 

While no messages are waiting to be processed, IdleAction is called and 
iterates through the gadgets, invoking their CommandEnable member 
function. 

See also: TGadget: -.CommandEnable 

virtual void Insert (TGadgetk gadget, TPlacement = After, 
TGadget *sibling = 0); 

Inserts a gadget before or after a sibling gadget (TPlacement). If sibling is 0, 
then the new gadget is inserted at either the beginning or the end of the 
gadget list. If this window has already been created, LayoutSession needs to 
be called after inserting gadgets. 

See also: TGadgetWindowr.LayoutSession, TGadgetWindow::Remove 

virtual void LayoutSession (') ; 

LayoutSession is typically called when a change occurs in the size of the 
margins or gadgets or when gadgets are added or deleted. LayoutSession 
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NextGadget 



Remove 



SetDirection 



SetHintCommand 



SetHintMode 



SetMargins 



SetShrinkWrap 



calls TileGadgets to tile the gadgets in the specified direction and Invalidate 
to mark the area as invalid (needs repainting). 

See also: TGadgetWindow "Insert, TGadgetWindowr.Remove, 
T 'Window: Invalidate 

inline TGadget *NextGadget (TGadget& gadget) const; 

Returns the next gadget after gadget or if none exists. 

virtual TGadget* Remove (TGadget& gadget); 

Removes a gadget from the gadget window. The gadget is returned but not 
destroyed. Remove returns if the gadget is not in the window. 

If this window has already been created, the calling application must call 
LayoutSession after any gadgets have been removed. 

See also: TGadgetWindowr.Insert, TGadgetWindow::LayoutSession 

virtual void SetDirection (TTileDirection direction); 

Sets the horizontal or vertical orientation of the gadgets. If the gadget 
window is already created, SetDirection readjusts the dimensions of the 
gadget window to fit around the gadgets. 

See also: TGadgetWindow r.GetDirection 

void SetHintCommand (int id); 

Simulates menu selection messages so that ObjectWindows command 
processing can display command hints. 

See also: WMJAENUSELECT, WM_ENTERIDLE 

inline void SetHintMode (THintMode hintMode) ; 

Sets the mode of the hint text. Defaults to PressHints (displays hint text 
when a button is pressed). 

See also: THintMode enum 

void SetMargins (TMargins &margins); 

Sets or changes the margins for the gadget window and calls LayoutSession. 

See also: TGadgetWindowr.Margins 

void SetShrinkWrap (BOOL shrinkWrapWidth, BOOL shrinkWrapHeight) ; 

Sets the width and height of the data members. By default, if the tile 
direction is horizontal, ShrinkWrapWidth is FALSE and ShrinkWrapHeight is 
TRUE. Also by default, if the direction is vertical, ShrinkWrapWidth is TRUE 
and ShrinkWrapHeight is FALSE. 
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Protected data members 



AtMouse 

BkgndBrush 

Capture 



Direction 



DirtyLayout 



Font 



FontHeight 



Gadgets 



HintMode 



Margins 



NumGadgets 



TGadget* AtMouse; 

The last gadget at the mouse position. 

TBrush* BkgndBrush; 

The color of the background brush. 

TGadget *Capture; 

Points to the gadget that currently has the mouse capture; otherwise, if no 
gadget has the mouse capture, Capture is 0. 

See also: TGadgetWindow::GadgetSetCapture 

TTileDirection Direction; 

The direction of the tiling — either horizontal or vertical. 

BOOL DirtyLayout; 

Indicates the layout has changed and gadgets need to be re-tiled. Using 
DirtyLayout avoids redundant tiling when gadget windows are created. 

See also: TGadgetWindowr.LayoutSession 

TFont *Font; 

Points to the font used to calculate layout units. 

See also: TGadgetWindowr.GetFont 

UINT FontHeight; 

Holds the height of the gadget window's font. 

See also: TGadgetWindowr.GetFont 

TGadget *Gadgets; 

Points to the first gadget in the gadget list. 

THintMode HintMode; 

Holds the hint text mode. 

See also: THintMode enum 

TMargins Margins; 

Holds the margin values for the gadget window. 

See also: TGadgetWindowrSetMargins 

UINT NumGadgets; 



218 



ObjectWindows 2.0 Reference Guide 



TGadgetWindow class 



ShrinkWrapHeight 



ShrinkWrapWidth 



WideAsPossible 



The number of gadgets in the window. 

BOOL ShrinkWrapHeight; 

If ShrinkWrapHeight is TRUE, the window will shrink its width to fit the 
tallest gadget for horizontally tiled gadgets. 

See also: TGadgetWindow:: Set ShrinkWrap 

BOOL ShrinkWrapWidth; 

If ShrinkWrapWidth is TRUE, the window will shrink its width to fit the 
widest gadget for vertically tiled gadgets. 

See also: TGadget Window r.Set ShrinkWrap 

UINT WideAsPossible; 

The number of gadgets that are as wide as possible. 

Protected member functions 



Create 



EvLButtonDown 



EvLButtonUp 



EvMouseMove 



EvSize 



BOOL Create (); 

Overrides TWindow member function and chooses the initial size of the 
gadget if shrink-wrapping was requested. 

See also: TGadgetWindow: :SetShrinkWrap 

void EvLButtonDown (UINT modKeys, TPoint& point); 

Responds to a left button-down mouse message by forwarding the event to 
the gadget positioned under the mouse. 

void EvLButtonUp (UINT modKeys, TPoint& point); 

Responds to a left button-up mouse message by forwarding the event to the 
gadget that has the capture. 

void EvMouseMove (UINT modKeys, TPoint& point) ; 

If mouse events are captured, EvMouseMove responds to a mouse move 
message by forwarding the event to the gadget that has the capture. 

void EvSize(UINT sizeType, TSize &) ; 

Calls TWindow r.EvSize to perform any default processing. If DirtyLayout 
TRUE and WideAsPossible is greater than 0, EvSize sets DirtyLayout to TRUE 
and calls TileGadgets to readjust the size and Invalidate to mark the area for 
redrawing. 

See also: TWindow: :EvSize 
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EvSysColorChange void EvSysColorChange I 



GetDesiredSize 



GetlnnerRect 



GetMargins 
LayoutUnitsToPixels 



Paint 



PaintGadgets 



EvSysColorChange, which is called when any system colors have changed, 
forwards the event to all gadgets. 

virtual void GetDesiredSize (TSize &size) ; 

If shrink-wrapping was requested, GetDesiredSize returns the size needed to 
accommodate the borders and the margins of the widest and highest 
gadget; otherwise, it returns the width and height in the window's Attr 
structure. 

If you want to leave extra room for a specific look (for example, a separator 
line between gadgets, a raised line, and so on), you can override this 
function. However, if you override GetDesiredSize, you will probably also 
need to override GetlnnerRect to calculate your custom inner rectangle. 

See also: TGadgetWindow: -.GetlnnerRect 

virtual void GetlnnerRect (TRect &); 

GetlnnerRect computes the rectangle inside of the borders and margins of 
the gadget. 

If you want to leave extra room for a specific look (for example, a separator 
line between gadgets, a raised line, and so on), you can override this 
function. If you override GetlnnerRect, you will probably also need to 
override GetDesiredSize to calculate your custom total size. 

See also: TGadgetWindow. -.GetDesiredSize 

void GetMargins (TMargins&, int &left, int &right, int &top, int &bottom) ; 

Returns the left, right, top, and bottom margins in pixels. 

int LayoutUnitsToPixels (int units); 

Converts layout units to pixels. A layout unit is determined by dividing the 
window font height by eight. 

See also: TGadgetWindow: -.LayoutSession 

void Paint (TDC& dc, BOOL erase, TRect& rect); 

Puts the font into the device context and calls PaintGadgets. 

See also: TGadgetWindow: -.PaintGadgets 

virtual void PaintGadgets (TDC& dc, BOOL erase, TRect& rect); 

Called by Paint to repaint all of the gadgets, PaintGadgets iterates through 
the list of gadgets, determines the gadget's area, and repaints each gadget. 
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You can override this function to implement a specific look (for example, 
separator line, raised, and so on). 

See also: TGadgetWindow: :EvPaint 

PositionGadget virtual void PositionGadget(TGadget ^previous, TGadget *next, TPoint& 

point) ; 

PositionGadget is called to allow spacing adjustments to be made before 
each gadget is positioned. 

See also: TGadgetWindow: :TileGadgets 

TNeGadgetS virtual void TileGadgetsO ; 

Tiles the gadgets in the direction requested (horizontal or vertical). 
Calls PositionGadget to give derived classes an opportunity to adjust the 
spacing between gadgets in their windows. 

See also: TGadgetWindow: -.PositionGadget 



Response table entries 



Response table entry 



Member function 



EV_WM_LBUTTONDOWN 

EV_WM_LBUTTONUP 

EV_WM_MOUSEMOVE 

EV_WM_SIZE 

EV_WM SYSCOLORCHANGE 



EvLButtonDown 

EvLButtonllp 

EvMouseMove 

EvSize 

EvSysColorChange 



TGadgetWindowFont class 



gadgetwi.h 



Derived from TFont, TGadgetWindowFont is a specific font used in gadget 
windows for sizing and default text. You can specify the point size of the 
font (not the size in pixels) and whether it is bold or italic. You can use a 
variety of the Windows API FW_xxxx or FF_xxxx constants to set the font 

type- 
Public constructors 



Constructor TGadgetWindowFont (int pointSize = 10, BOOL bold = FALSE, 

BOOL italic = FALSE) ; 
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TGauge class 



Constructs a TGadgetWindowFont interface object with a default point size 
of 10 picas without bold or italic typeface. By default, the constructor 
creates the system font: a variable- width, sans-serif Helvetica. 

gauge.h 

A streamable class derived from TControl, TGauge defines the basic 
behavior of gauge controls. Gauges are display-only horizontal or vertical 
controls that provide duration or analog information about a particular 
process. In general, horizontal gauges with a broken (dashed-line) bar are 
used to display short-duration, process information whereas horizontal 
gauges with a solid bar are used to illustrate long-duration, process 
information. Usually, vertical gauges are preferred for displaying analog 
information. 



Public member functions 



GetRange 

GetValue 

SetLed 

SetRange 
SetValue 



inline void GetRange (int& min, int& max) const 

Gets the minimum and maximum values for the gauge. 

inline int GetValue () const 

Gets the current value of the gauge. 

void SetLed(int spacing, int thick = 90); 

Sets the LedSpacing and LedThick data members to the values spacing and 
thick. 

void SetRange(int min, int max); 

Sets the Min and Max data members to min and max values returned by the 
constructor. If Max is less than or equal to Min, SetRange resets Max to Min 
plus 1. 

void SetValue (int value); 

Restricts the value so that it is within the minimum and maximum values 
established for the gauge. If the current value has changed, SetValue marks 
the old position for repainting. Then, it sets the data member Value to the 
new value. 
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Public constructors 



Constructor TGauge (TWindow* parent, const char far* title, int id, 

int X, int Y, int W, int H, BOOL isHorizontal = TRUE, 
int margin = 0, TModule* module = 0); 

Constructs a TGauge object with borders that are determined by using the 
value of SM_CXBORDER from r.GetSystemMetrics. Sets IsHorizontal to 
isHorizontal Sets border thickness and spacing between dashed borders 
(LEDs) to 0. Sets the range of possible values from to 100. 

Protected data members 

IsHorizontal int IsHorizontal; 

Set to the isHorizontal argument of the constructor. IsHorizontal is TRUE if 
the gauge is horizontal and FALSE if it is vertical. 

LedSpacing . int LedSpacing; 

Holds the integer value (in gauge units) of the spacing between the broken 
bars of the gauge. 

LedThick int LedThick; 

Holds the thickness of the broken bar. 
Max int Max; 

Holds the maximum value (in gauge units) displayed on the gauge. 
Min int Min; 

Holds the minimum value (in gauge units) displayed on the gauge. 

Margin int Margin; 

The border width and height of the gauge. Margin is calculated by 
multiplying the value returned by GetSystemMetrics in the SM_CXBORDER 
parameter by the value in the constructor's parameter, margin. 

Value int Value; 

Holds the current value of the gauge. 

Protected member functions 



EvEraseBkgnd 



BOOL EvEraseBkgnd(HDC); 
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Overrides TWindow's EvEraseBkgnd function and erases the background of 
the gauge. Whenever the background is repainted, EvEraseBkgnd is called to 
avoid flickering. 



See also: TWindow::EvEraseBkgnd 

Pai"t void Paint ( ) ; 



Overrides TWindow's Paint function and paints the area and border of the 
gauge. Assigns the horizontal and vertical border values of the gauge's 
rectangle to the values of the SM_CXBORDER and SM_CYBORDER 
parameters of GetSystemMetrics. Determines the color by using the value 
returned by the COLOR_BTNSHADOW option of GetSysColor and uses the 
values in LedSpacing and IsHorizontal to draw a horizontal or vertical gauge 
with solid or broken bars. 

See also: TGauger.LedSpacing, TGauge: IsHorizontal 



Response table entries 






Response table entry 


Member function 


EV_WM_ERASEBKGND 


EvEraseBkgnd 



TGdiObject class gdiobjec.h 

GdiObject is the root, pseudo-abstract base class for ObjectWindows's GDI 
(Graphics Device Interface) wrappers. WIN API calls that take a GDI 
handle argument are typically replaced by simpler ObjectWindows 
member function invocations in which the handle (and possibly other 
arguments) is "supplied" by the calling object. The TGdiOject-based classes 
let you work with a GDI handle and construct a C++ object with an aliased 
handle. Some GDI objects are also based on TGdiObject for handle 
management. Generally, the TGdiObject-based class hierarchy handles all 
GDI objects apart from the DC (Device Context) objects handled by the 
TDC-based tree. 

The five DC selectable classes (TPen, TBrush, TFont, TPalette, and TBitmap), 
and the TIcon, TCursor, TDib, and TRegion classes, are all derived directly 
from TGdiObject. 

TGdiObject maintains the GDI handle and a ShouldDelete flag that 
determines if and when the handle and object should be destroyed. 
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enum 
TAutoDelete 



enum TType 



GetObject 



Protected constructors are provided for use by the derived classes: one for 
borrowed handles, and one for normal use. 

An optional orphan control mechanism is provided. By default, orphan 
control is active, but you can turn it off by defining the 
NO_GDI_ORPHAN_CONTROL identifier: 

idefine N0_GDI_0RPHAN_C0NTR0L 

With orphan control active, the following static member functions are 
available: 

RefAdd, RefCount, RefDec, RefFind, Refine, and RefRemove. 

These maintain object reference counts and allow safe orphan recovery and 
deletion. Macros, such as OBJ_REF_ADD, let you deactivate or activate 
your orphan control code by simply defining or undefining 
NO_GDI_ORPHAN_CONTROL. When NO_GDI_ORPHAN_CONTROL is 
undefined, for example, OBJ_REF_ADD(handle, type) expands to 
TGdiObject: :RefAdd((handle), (type)), but when 
NO_GDI_ORPHAN_CONTROL is defined, the macro expands to handle. 

Public data members 

enum TAutoDelete (NoAutoDelete, AutoDelete) ; 

Enumerates the flag values for GDI Handle constructors. This flag is used 
to control GDI object deletion in the destructors. 

See also: The second protected constructor in this class 

enum TType ( TpNone , TpPen, TpBrush, TpFont, TpPalette, TpBitmap, 
TpTextBrush) ; 

This enumeration is used to store the object type in the struct TObjInfo. This 
internal structure is used to track object reference counts during debugging 
sessions. 

See also: TGdiObject::RefXXX 

Public member functions 

inline int GetObject (int count, void far* object) const; 

Wrapper for the Win API GetObject(Handle, count, object) call. Obtains 
information about this GDI object and places it in the object buffer. If the call 
succeeds and object is not 0, GetObject returns the number of bytes copied to 
the object buffer. If the call succeeds and object is 0, GetObject returns the 
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IsGDIObject 




IsOk 



RefAdd 



RefCount 



RefDec 



number of bytes needed in the object buffer for the type of object being 
queried. 

See also: ::GetObject, TPen::GetObject 

inline BOOL IsGDIObject () ; 

Returns TRUE if the data member Handle represents an existing (valid) GDI 
object. 

See also: TGdiObject::IsOK, TGdiObject: -.Handle 

inline BOOL IsOK() const; 

Returns TRUE if the current Handle is nonzero. 

See also: TGdiObject::Handle 

static void RefAdd (HANDLE handle, TType type) ; 

Available only if orphan control is active (that is, if 
NO_GDI_ORPHAN_CONTROL is undefined). RefAdd adds a reference 
entry for the object with the given handle and type to the ObjInfoBag table 
and sets the reference count to 1. If the table already has a matching entry, 
no action is taken. 

See also: TGdiObjectr.RefXXX, macro OBJ_REF_ADD 

static int RefCount (HANDLE handle); 

Available only if orphan control is active, that is, if 

NO_GDI_ORPHAN_CONTROL is undefined. RefCount returns this object's 
current reference count or -1 if the object is not in the ObjInfoBag table. 

See also: TGdiObjectr.RefXXX, macro OBJ_REF_COUNT 

static void RefDec (HANDLE handle); 

static void RefDec (HANDLE handle, BOOL wantDelete) ; 

Available only if orphan control is active, that is, if 
NO_GDI_ORPHAN_CONTROL is undefined. RefDec decrements this 
object's reference count by 1 and deletes the object when the reference count 
reaches zero. A warning is issued if the deletion was supposed to happen 
but didn't. Likewise, a warning is issued if the deletion wasn't supposed to 
happen but did. The deleted object is also detached from the ObjInfoBag 
table. 

The second version of RefDec is available only if the _ _TRACE identifier is 
defined. You can vary the normal deletion strategy by setting wantDelete to 
TRUE or FALSE. 

See also: TGdiObjectr.RefXXX, macro OBJ_REF_DEC 
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RefFind 



Refine 



RefRemove 



static TObjInfo* RefFind (HANDLE object); 

Available only if orphan control is active (that is, if NO_GDI 
_ORPHAN_CONTROL is undefined). RefFind searches the ObjInfoBag table 
for an entry for the given object. If found, the object's type and reference 
count are returned in the specified TObjInfo object. RefFind returns if no 
match is found. 

See also: TGdiObjectr.RefXXX, TObjInfo, TObjInfoBag 

static void Refine (HANDLE handle); 

Available only if orphan control is active (that is, if 

NO_GDI_ORPHAN_CONTROL is undefined). Refine increments by 1 the 
reference count of the object associated with handle. 

See also: TGdiObject rRefXXX, macro OB] _REF_INC 

static void RefRemove (HANDLE handle); 

Available only if orphan control is active (that is, if 
NO_GDI_ORPHAN_CONTROL is undefined). RefRemove removes the 
reference entry to the object with the given handle from the ObjInfoBag table. 
If the given handle is not found, no action is taken. 

See also: TGdiObjectr.RefXXX, macro OBJ_REF_REMOVE 



Protected data members 



Handle 



ShouldDelete 



HANDLE Handle; 

The GDI handle of this object. 

See also: TGdiObject constructors 

BOOL ShouldDelete; 

Set TRUE if the destructor needs to delete this object's GDI handle. 

See also: TGdiObject constructors and destructor 



Constructor 



Protected constructors and destructor 



TGdiObject (); 

This default constructor sets Handle to and ShouldDelete to TRUE. This 
constructor is intended for use by derived classes that must set the Handle 



member. 
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Constructor 



Destructor 



OBJ REF ADD 



OBJ REF COUNT 



See also: TGdiObjectr.Handle, TGdiObject::ShouldDelete 

TGdiObject (HANDLE handle, TAutoDelete autoDelete = NoAutoDelete) ; 

This constructor is intended for use by derived classes only. The Handle 
data member is "borrowed" from an existing handle, given by the 
argument handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle will not be deleted when the object is . 
destroyed. 

See also: enum TAutoDelete, TGdiObject::ShouldDelete 

virtual -TGdiObject () ; 

If ShouldDelete is FALSE, no action is taken. Otherwise, with ShouldDelete 
TRUE, the action of the destructor depends on whether orphan control is 
active or not. If orphan control is inactive (that is, if 
NO_ORPHAN_CONTROL is defined) -TGdiObject deletes the GDI object 
by calling ::DeleteObject(Handle). If orphan control is active (the default), 
-TGdiObject calls RefDec(Handle, TRUE), so that rDeleteObject(Handle) is 
called only if the object's reference count is 0. 

See also: TGdiObjectr.Handle, TGdiObjectr.ShouldDelete, TGdiObject::RefXXX 

Macros 

0BJ_REF_ADD( handle, type) 

If orphan control is active (the default), OBJ_REF_ADD(handle, type) is 
defined as TGdiObject ::RefAdd( (handle), (type)). The latter adds to the 
ObjInfoBag table a reference entry for the object with the given handle and 
type, and sets its count to 1. 

If orphan control is inactive, OBJ_REF_ADD(handle) is defined as handle. 
This macro lets you write orphan control code that can be easily 
deactivated with the single statement #def ine N0_GDl_0RPHAN_C0NTR0L. 

See also: TGdiObjectr.RefAdd 

0BJ_REF_C0UNT (handle) 

If orphan control is active (the default), OBJ_REF_COUNT(handle) is 
defined as TGdiObject ::RefCount( (handle)). The latter returns the reference 
count of the object with the given handle, or -1 if no such object exists. If 
orphan control is inactive, OBJ_REF_COUNT(handle) is defined as -1. This 
macro lets you write orphan control code that can be easily deactivated 
with the single statement #def ine N0_GDI_0RPHAN_C0NTR0L. 
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See also: TGdiObjectr.RefCount 
OBJ_REF_DEC OBJ_REF_DEC (handle, wantDelete) 



If orphan control is active (the default), OBJ_REF_DEC(handle, wantDelete) is 
defined as either TGdiObject::RefDec((handle)) or TGdiObject::RefDec((handle), 

(wantDelete)). The latter format occurs only if TRACE is defined. 

RefDec(handle) decrements the reference count of the object associated with 
handle and optionally deletes orphans or warns you of their existence. If 
orphan control is inactive, OBJ_REF_DEC(handle) is defined as handle. This 
macro lets you write orphan control code that can be easily deactivated 
with the single statement #def ine N0_GDI_0RPHAN_C0NTR0L. 



See also: TGdiObjectr.RefDec 
OBJ_REF_INC OBJ_REF_INC (handle ) 



If orphan control is active (the default), OBJ_REF_INC(handle) is defined as 
TGdiObject::RefInc((handle)). The latter increments the reference count of the 
object associated with handle. If orphan control is inactive, 
OBJ_REF_DEC(handle) is defined as handle. This macro lets you write 
orphan control code that can be easily deactivated with the single statement 
ttdefine N0_GDI_0RPHAN_C0NTR0L. 

See also; TGdiObjectr.Reflnc 

OBJ_REF_REMOVE 0BJ_REF_REM0VE( handle) 

If orphan control is active (the default), OBJ_REF_REMOVE(handle) is 
defined as TGdiObject::RefRemove((handle)). The latter removes from the 
ObjInfoBag table the reference entry for the object associated with handle. If 
orphan control is inactive, OBJ_REF_REMOVE(handle) is defined as handle. 
This macro lets you write orphan control code that can be easily 
deactivated with the single statement #def ine N0_GDI_0REHAN_C0NTR0L. 

See also: TGdiObjectr.RefRemove 

TGdiObject::TXGdi class gdibase.h 

Describes an exception resulting from GDI failures such as creating too 
many TWindow DCs. This exception occurs, for example, if a dc driver 
can't be located or if a DIB file can't be read. 

The following code from the PAINT. CPP sample program on your 
distribution disk throws a TXGdi exception if a new DIB can't be created. 
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void TCanvas: :NewDib(int width, int height, int nColors) 

■ • < 

TDib* dib; 

try { 

dib = new TDib(width, height, nColors); 
}. 
catch (TGdiObject::TXGdi& x) { 

MessageBox( "Could Not Create DIB", GetApplication()->Name, MB_0K) ; 

return; .■ -- 

} 

Public constructors 

Constructor TXGdi(UINT resld = IDS_GDIFAILURE, HANDLE = 0) ; . 

Constructs a TXGdi object with a default IDS_GDIFAILURE message. 



Public member functions 



Msg static string Msg(UINT resld, HANDLE); 

Converts the resource ID to a string and returns the string message. 

TGroupBox class groupbox.h 

An instance of a TGroupBox is an interface object that represents a 
corresponding group box element in Windows. Generally, TGroupBox 
objects are not used in dialog boxes or dialog windows (TDialog), but are 
used when you want to create a group box in a window. 

Although group boxes don't serve an active purpose onscreen, they 
visually unify a group of selection boxes such as check boxes and radio 
buttons or other controls. Behind the scenes, however, they can take an 
important role in handling state changes for their group of controls 
(normally check boxes or radio buttons). 

For example, you might want to respond to a selection change in any one of 
a group of radio buttons in a similar manner. You can do this by deriving a 
class from TGroupBox that redefines the member function SelectionChanged. 

Alternatively, you could respond to selection changes in the group of radio 
buttons by defining a response for the group box's parent. To do so, define 
a child-ID-based response member function using the ID of the group box. 
The group box will automatically send a child-ID-based message to its 
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parent whenever the radio button selection state changes. This class is 
streamable. 

Public data members 

Notify Parent B 00L NotifyParent; 

Flag that indicates whether parent is to be notified when the state of the 
group box's selection boxes has changed. NotifyParent is TRUE by default. 

Public constructors 

Constructor TGroupBox (TWindow* parent, int Id, const char far *text, int x, int y, 

int w, int h, TModule* module = 0); 

Constructs a group box object with the supplied parent window (Parent), 
control ID (Id), associated text (text), position (x, y) relative to the origin of 
the parent window's client area, width (w), and height (h). Invokes the 
TControl constructor with similar parameters, then modifies Attr. Style, 
adding BS_GROUPBOX and removing WSJTABSTOP. NotifyParent is set to 
TRUE; by default, the group box's parent is notified when a selection 
change occurs in any of the group box's controls. 

See also: TControlr.TControl 

Constructor TGroupBox (TWindow* parent, int resourceld, TModule* module = 0); 

Constructs a TGroupBox object to be associated with a group box control of 
a TDialog. Invokes the TControl constructor with identical parameters. 
resourcelD must correspond to a group box resource that you define. 

See also: TControl::! Control, T Window ::DisableTransfer 

Public member functions 

SelectionChanged virtual void SelectionChanged( int controlld) ; 

If NotifyParent is TRUE, SelectionChanged notifies the parent window of the 
group box that one of its selections has changed by sending it a child-ID- 
based message. This member function can be redefined to allow the group 
box to handle selection changes in its group of controls. 
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Protected member functions 



GetClassName c har far* GetClassName (); 

GetClassName returns the name of TGroupBox's Windows registration class, 
"BUTTON." If BWCC is enabled, GetClassName returns BUTTON_CLASS. 



THintMode enum 



gadgetwi.h 



Enumerates the hint mode settings of the gadget — either no hints, hints 
when a button is pressed, or hints when the mouse passes over a gadget. 

enum THintMode 

See also: TGadgetWindow::GetHintMode 



THSIider class 



slider.h 



Constructor 



Derived from TSlider, THSIider provides implementation details for 
horizontal sliders. See TSlider for an illustration of a horizontal slider. 



Public constructors 



THSIider (TWindow* parent, int id, int X, int Y, int W, int H, 
TResId thumbResId, TModule* module = 0); 



Constructs a slider object. 



Protected member functions 



HitTest 



NotifyParent 



int HitTest (TPointk point); 

Overrides TSlider's virtual function and gets information about where a 
given X, Y location falls on the slider. The return value is in scrollCodes. 

See also: T Slider ::HitT est 

void NotifyParent {int scrollCode, int pos=0); 

Overrides TSlider's virtual function and sends a WS_HSCROLL message to 
the parent window. 

See also: TSliderr.NotifyParent 
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PaintRuler 



PaintSlot 



PointToPos 



PosToPoint 



void PaintRuler (TDC&); 

Overrides TSlider's virtual function and paints the horizontal ruler. 

See also: TSlider::PaintRuler 

void PaintSlot (TDC&) ; 

Overrides TSlider's virtual function and paints the slot in which the thumb 
slides. 

See also: TSlider::PaintSlot 

int PointToPos (TPoint& point) ; 

Overrides TSlider's virtual function and translates an X,Y point to a position 
in slider units. 

See also: TSlider::PointToPos 

TPoint PosToPoint (int pos); 

Overrides TSlider's virtual function and translates a position in slider units 
to an X,Y point. 

See also: TSlider::PosToPoiiit 



TIC class 



dc.h 



Derived from TDC, TIC is a DC class that provides a constructor for 
creating a DC object from explicit driver, device, and port names. 

Public constructors 

Constructor TIC (const char far* driver, const char far* device, const char far* 

output, const DEVMODE far* initData=0) ; 

Creates a DC object with the given driver, device, and port names and 
initialization values. 

See also: ::DeviceCapabilitiesEx, DEVMODE struct, TDCr.GetDeviceCaps 



Tlcon class 



gdiobjec.h 



Tlcon, derived from TGdiobject, represents the GDI object icon class. Tlcon 
constructors can create icons from a resource or from explicit information. 
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Because icons are not real GDI objects, the Tlcon destructor overloads the 
base destructor, -TGdiObjectO. 

Public constructors and destructor 



Constructor 



Constructor 



Constructor 



Constructor 



Constructor 



Constructor 




Constructor 




TIcon(HICON handle, TAutoDelete autoDelete = NoAutoDelete) ; 

Creates a Tlcon object and sets the Handle data member to the given 
borrowed handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle will not be deleted when the C++ object 
is destroyed. 

See also: TGdiObjectr.Handle, TGdiObject:: ShouldDelete, 

Tlcon (HINSTANCE instance, const TIcon& icon); 

Creates a copy of the given icon object by calling the Win API function 

CopyIcon(instance, icon). 

See also: ::CopyIcon 

Tlcon (HINSTANCE instance, TResID resID) ; 

Creates an icon object from the given resource. 

See also: r.Loadlcon 

Tlcon (HINSTANCE instance, const char far* filename, int index); 

Creates an icon object from the given resource file. 

See also: ::ExtractIcon 

Tlcon (HINSTANCE instance, const TSize& size, int planes, int bitsPixel, 
const void far* andBits, const void far* xorBits); 

Creates an icon object with the given values. 

See also: y.Createlcon 

TIcon(const void* resBits, DWORD resSize) ; 

Creates an icon object of the given size from the bits found in the resBits 
buffer. 

See also: r.CreatelconFromResource 

Tlcon (const ICONINFO*'' iconlnf o) ; 

Creates an icon object with the given ICONINFO information. 

See also: ::CreateIconIndirect 
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Tlcon class 



-Tlconl 



Overrides the base destructor to call ::DestroyIcon instead of the default 
r.DeleteObject. 

See also: ~TGdiObject, ::DestroyIcon 



Public member functions 



Geticonlnfo 




operator HICONQ 




inline BOOL Geticonlnfo (ICONINFO* iconlnfo) const; 

Retrieves information about this icon and copies it in the given ICONINFO 
structure. Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: : -.Geticonlnfo, struct ICONINFO 

inline operator HICONO const; 

Typecasting operator that converts this icon's Handle to type HICON (the 
Windows data type representing the handle to an icon resource). 



TlnputDialog class 



inputdia.h 



TlnputDialog provides a generic dialog box to retrieve text input by a user. 
When the input dialog box is constructed, its title, prompt, and default 
input text are specified. TlnputDialog is a streamable class. 

Public data members 



buffer 



BufferSize 



prompt 



char far* buffer; 

Pointer to the buffer that returns the text retrieved from the user. When 
passed to the constructor of the input dialog box, contains the default text 
to be initially displayed in the edit control. 

int BufferSize; 

Contains the size of the buffer that returns user input. 

char far* prompt; 

Points to the prompt for the input dialog box. 
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Constructor 



Public constructors 



TlnputDialog (TWindow* parent, const char far *title, 

const char far *prompt, char far* buffer, int bufferSize, 
TModule* module = 0) ; 

Invokes TDialog's constructor, passing it parent, the resource identifier and 
module. Sets the caption of the dialog box to title and the prompt static 
control to prompt. Sets the Buffer and BufferSize data members to buffer and 
bufferSize. 



See also: TDialogr.TDialog 



Public member function 



TransferData void TransferData(TTransferDirection direction); 

Transfers the data of the input dialog box. If direction is tdSetData, sets the 
text of the static and edit controls of the dialog box to the text in prompt and 
buffer. If direction is tdGetData, fills the buffer with the current text of the 

Editor. 



Protected member function 



SetupWindow virtual void SetupWindowO ; ' 

In setting up the window, SetupWindow calls TDialog:: SetupWindow, then 
limits the number of characters the user can enter to bufferSize - 1. 



TlnStream class 



docview.h 



Constructor 



Derived from TStream and istream, TlnStream is a base class used for 
defining input streams for documents. 

Public constructors 

TlnStream (TDocumentk doc, LPCSTR name, int mode); 

Constructs a TlnStream object, doc refers to the document object, name is the 
user-defined name of the stream, and mode is the mode of opening the 
stream. 
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See also: TOutStream, ofXXXX document open enum, shdocument sharing 
enum 



TKeyboardModeTracker class 



keymodeth 



Note: The functionality 

of this class is provided 

in TStatusBar. This class 

no longer exists. 



Derived from TWindow, TKeyboardModeTracker is a streamable, mix-in class 
designed to track changes in keyboard modes that occur when the toggle 
keys (CapsLock, NumLock, ScrollLock), or edit keys (Ins) keys are pressed. By 
setting updateStatusBar in the constructor to TRUE, you can also specify that 
the class updates the status bar whenever a mode change occurs. 



Public data members 



TModelndicator enum TModelndicator 

A subtype of the mode indicators supported by TStatusBar, 
TKeyboardModeTracker'^ mode indicator sets the CapsLock, NumLock, 
ScrollLock, and Overtype indicators equivalent to those of TStatusBar's mode 
indicators. 

See also: TStatusBar '/.TModelndicator 



Public constructors 



Constructor TKeyboardModeTracker (TWindow* parent, BOOL updateStatusBar = TRUE, UINT 

modes = CapsLock I NumLock I Overtype, TModule* 
module = 0) ; 

Constructs a TKeyboardModeTracker object that keeps track of the keyboard 
modes and updates the status bar if updateStatusBar is set to TRUE (the 
default value). You can use the modes parameter to indicate which modes 
you want your application to track. 

Protected data members 



Modes 



UINT Modes; 

One or more of the keyboard indicator modes that you want your program 
to track. The indicator modes correspond to the following virtual key 
codes: 
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OvertypeState 

ScrollLockState 

UpdateStatusBar 



Mode 



Virtual key code 



CapsLock 7 


VK CAPITAL 


NumLock 


VK NUMLOCK 


Overtype 


VK INSERT 


ScrollLock 


VK SCROLL 



BOOL OvertypeState; 

Is TRUE if overtype mode is activated. 

BOOL ScrollLockState 

Is TRUE if scroll lock mode is activated. 

BOOL UpdateStatusBar; 

Is TRUE if changes in keyboard modes are to be reflected on the status bar. 

See also: TStatusBar::TStatusBar 



Protected member functions 



DoKeyDown 



DoSetFocus 



TEventStatus DoKeyDown (UINT key, UINT repeatCount, UINT flags); 

DoKeyDown translates the virtual key code into a movement, calls 
TStatusBar's member function to change the status bar's mode indicator, and 
then returns TEventStatus. key indicates the virtual key code of the pressed 
key, repeatCount holds the number of times the same key is pressed, flags 
contains one of the messages that translates to a virtual key (VK) code for 
the mode indicators. If UpdateStatusBar is TRUE and the state of the Ins key 
or ScrollLockkey changes, DoKeyDown passes the current state of the 
keyboard to TStatusBar::SetModeIndicator, which updates the mode 
indicators on the status bar. If UpdateStatusBar is TRUE and the state of the 
NumLock key or CapsLockkey changes, DoKeyDown passes the current state of 
the keys to TStatusBar::ToggleModeIndicator, which updates the mode 
indicators on the status bar. 

See also: TEventStatus enum, TKeyboardModeTracker r.EvKey Down 

TEventStatus DoSetFocus (HWND hWndLostFocus) ; 

Restores the focus to the active window and returns TEventStatus. 
hWndLostFocus contains a handle to the window that lost the focus. If 
UpdateStatusBar is TRUE, DoSetFocus determines if any changes have 
occurred in the keyboard mode and, if appropriate, updates the status of 
the mode indicator on the status bar by calling TStatusBar::SetModeIndicator. 
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EvKeyDown 



EvSetFocus 



See also: TEventStatus enum, TKeyboardModeTrackerwEvSetFocus 

- void EvKeyDown (UINT key, UINT repeatCount, UINT flags); 

Responds to a key-down message by calling DoKeyDown. If DoKeyDown 
doesn't return IsComplete, EvKeyDown calls TVJindow: '.EvKeyDown. 

See also: TKeyboardModeTracker::DoKeyDown 

void EvSetFocus (HWND hWndLostFocus) ; 

Responds to a set-focus message by calling DoSetFocus. If DoSetFocus 
doesn't return IsComplete, EvSetFocus calls TWindowr.EvSetFocus. 

See also: TKeyboardModeTracker -.'.DoSetFocus 

OvertypeModeChange virtual void OvertypeModeChange(BOOL on); 

If overtyping is changed from on to off or vice versa, OvertypeModeChange 
is set to TRUE. 

ScrollLockModeChange virtual void ScrollLockModeChange(BOOL on); 

If scroll locking is changed from on to off or vice versa, 
ScrollLockModeChange is set to TRUE. 

Response table entries 



Response table entry 



Member function 



EV_WM_KEYDOWN 
EV_WM_SETFOCUS 



EvKeyDown 
EvSetFocus 



TLayoutConstraint struct 



layoutco.h 



TLayoutConstraint is a structure that defines layout constraints. Layout 
constraints are specified as a relationship between an edge or size of one 
window and an edge or size of one of the window's siblings or its parent. If 
a parent-child relationship is established between windows, the dimensions 
of the child windows are dependent on the parent window. A window can 
have one of its sizes depend on the size of the opposite dimension. For 
example, the width can be twice the height. TLayoutMetrics lists the 
relationships you can have among size and edge constraints 

LAYOUT.CPP in the OWLAPIXLAYOUT directory shows you the following 
example of how to set up layout constraints. 
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Layout child windows 



SSSCB3 



Yellow 
Cyan 



Layout Tweaker 



Oy 

O Width 
O Height 



MyEdge [imCenter 
Relationship ]| m Asls 



RelWin llmParent 



OtherEdge jlmTop 



Units ImLayoutUnitl 



Set these metrics to control 
the position and size of the 
layout child window 



Public data members 



MyEdge 



OtherEdge 



Relationship 



RelWin 



UINT MyEdge; 

MyEdge contains the name of the edge or size constraint (ImTop, ImBottom, 
ImLeft, ImRight, ImCenter, ImWidth, or ImHeight) for your window. 

See also: TWidthHeight enum 

UINT OtherEdge; 

OtherEdge contains the MyEdge contains the name of the edge or size 
constraint (ImTop, ImBottom, ImLeft, ImRight, ImCenter, ImWidth, or ImHeight) 
for the other window. 

See also: TWidthHeight enum 

TRelationship Relationship; 

Relationship specifies the type of relationship that exists between the two 
windows (that is, ImRightOf, ImLeftOf, ImAbove, ImBelow, ImSameAs, or 
ImPercentOf). A value of Im Absolute actually indicates that no relationship 
exists. 

See also: TRelationship enum 

TWindow *RelWin; 

RelWin is a pointer to the sibling windows or ImParent if the child is a 
proportion of the parent's dimensions. RelWin points to the window itself 
(this) if a child window's dimension is a proportion of one of its other 
dimensions (for example, its height is a proportion of its width). 
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union 
TLayoutConstraint 



TLayoutConstraint struct 



See also: TRelationship enum 

TMeasurementUnits Units; 

Units enumerates the units of measurement (either pixels or layout units) 
used to measure the height and width of the windows. Unlike pixels, 
layout units are based on system font size and will be consistent in their 
perceived size even if the screen resolution changes. 

See also: TMeasurementUnits enum 

union { 

int Margin; 

int Value; 

int Percent; 
}; 

This union is included for the convenience of naming the layout 
constraints. Margin is used for ImAbove, ImLeftOf, ImLeftOf, or ImRightOf 
enumerated values in TRelationship. Value is used for ImSameAs or 
ImAbsolute enumerated value in TRelationship. Percent is used for the 
ImPercentOf enumerated value in TRelationship. 

See also: TMeasurementUnits enum 

TLayoutMetrics class layoutwi.h 

TLayoutMetrics contains the four layout constraints used to define the 
layout metrics for a window. This table lists the constraints you can use for 
the X, Y, Height, and Width fields. 



Field Constraints 



X ImLeft, ImCenter, ImRight 

Y ImTop, ImCenter, ImBottom 

Height ImCenter, ImRight, ImWidth 

Width ImCenter, ImBottom, ImHeight 



If the metrics for the child window are relative to the parent window, the 
relation window pointer (ImParent) needs to be ImParent (not the actual 
parent window pointer). For example, 

TWindow* child = new TWindow(this, ""); 
TLayoutMetrics metrics; 

metrics. X. Set (ImCenter, ImSameAs, ImParent, ImCenter); 
metrics. Y. Set (ImCenter, ImSameAs, ImParent, ImCenter); 
SetChildLayoutMetrics(*child, metrics) ; 
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The parent window pointer (this) should not be used as the relation 
window pointer of the child window. 

Public data members 



Height 



Width 



X,Y 



Constructor 



TEdgeOrWidthConstraint Height; 

Contains the height size constraint, center edge, or bottom edge constraint 
of the window. 

TEdgeOrWidthConstraint Width; 

Contains the width size constraint, center edge, or right edge (ImRight) 
constraint of the window. 

TEdgeConstraint X, Y; 

X contains the X (left, center, right) edge constraint of the window. Y 
contains the Y (top, center, bottom) edge constraint of the window. 

Public constructors 

TLayoutMetrics ( ) ; 

Creates a TLayoutMetrics object and initializes the object by setting the units 
for the child and parent window to the specified layout units and the 
relationship between the two windows to what is defined in ImAsIs (of 
TRelationship). Sets the following default values: 

X.RelWin = 0; 

X.MyEdge = lmLe'ft; 

X. Relationship = ImAsIs; ' - ; " 

X. Units = lmLayoutUnits; 

X. Value = 0; 

Y.RelWin = 0; 

Y. MyEdge - lmTop; 

Y. Relationship = ImAsIs; 

Y. Units = lmLayoutUnits; 

Y. Value ..= 0; 

Width. RelWin = 0; 

Width. MyEdge = lmWidth; 

Width. Relationship = ImAsIs; 

Width. Units = lmLayoutUnits; 

Width. Value = 0; 

Height. RelWin = 0; . . - 

Height. MyEdge - lmHeight; 

Height. Relationship = ImAsIs ; 
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Height. Units = lmLayoutUnits; 
Height. Value = 0; 

The following program creates two child windows and a frame into which 
you can add layout constraints. 

♦include <owl\owl.h> 
.♦include <owl\framewin.h> 
♦include <owl\applicat.h> 
♦include <owl\layoutwi.h> 
♦include <owl\decorate.h> 
♦include <owl\decmdifr.h> 
. ♦ include <owl\layoutco.h> 
♦pragma hdrstop 

// Create a derived class. // 

class TMyDecoratedFrame : public TDecoratedFrame { 
public: 

TMyDecoratedFrame (TWindow* parent, const char far* title, 

TWindow& clientWnd, TWindow* MyChildWindow) ; 
void SetupWindow() ; 
{ 

TDecoratedFrame :": SetupWindow ( ) ; 
MyChi ldWindow- >ShowWindow(SW_NORMAL); 
MyChildWindow- >BringWindowToTop ( ) ; 
} ' 
}; 

// Setup a frame window. // 

TMyDecoratedFrame: : TMyDecoratedFrame (TWindow * parent, const char far* title, 
TWindowk clientWnd) 

: TDecoratedFrame (parent, title, clientWnd), 
TFrameWindow (parent, title, &clientWnd) , 
TWindow (parent, title) 
{ 
// Create a new TMyChi ldWindow. // 

MyChildWindow = new TWindow (this, "") ; 

MyChildWindow->Attr. Style |= WS_BORDER |WS_VISIBLE |WS_CHILD; 

MyChildwindow->SetBkgndColor (RGB (0,100,0)); 

// Establish metrics for the child window. // 

TLayoutMetrics layoutMetrics; 

layoutMetrics.X. Absolute (lmLeft, 10); 

layoutMetrics. Y. Absolute (lmTop, 10) ; 

layoutMetrics. Width. Absolute ( 80 ) ; • . 

layoutMetrics. Height. Absolute ( 80 ) ; 

) , " 

SetChildLayoutMetrics(*MyChildWindow, layoutMetrics); 
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class TMyApp : public TApplication { 
public: 

virtual void InitMainWindowO 
{ . . ■ 

TWindow* client = new TWindow(0, "title"); 

MainWindow = new TMyDecoratedFrarae(0, "Layout Window Ex", *client); 
} 
}; 

int OwlMain(int, char**) { 

return TMyApp . Run ( ) ; 
■} 

TLayoutWindow class layoutwi.h 

TLayoutWindow is derived from TWindow and provides options for defining 
the layout metrics for a window. See TLayoutConstraint for a definition of 
the layout constraints and TLayoutMetrics for a description of the metrics 
you can use to set up layout constraints. 

The following examples show how to set up various metrics using edge 
constraints. For purposes of illustration, these examples use a parent-child 
relationship, but you can also use a child-to-child (sibling) relationship. 
Keep in mind that, as usual, if you move the parent's origin (the left and top 
edges), the child will move with the parent window. 

Examples 

Ejxample 1 To create growable windows, set the top and left edges of the child 

window's boundaries in a fixed relationship to the top and left edges of the 
parent's window. In this example, if you expand the bottom and right edges 
of the parent, the child's bottom and right edges grow the same amount. 
Both the X and Y constraints are 10 units from the parent window's edges. 
Both the Width and Height constraints are 40 layout units from the parent 
window's edges. Specifically, Width (ImWidth) is 40 units to the left of the 
parent's right edge (lmLeftOf= ImSameAs + offset or sameas - 40). 
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Example 2 



Use the following layout constraints: 

layoutmetrics.X.Set (lmLeft, lmRightOf, ImParent, lmLeft, 10); 
layoutmetrics. Y. Set (lmTop, ImBelow, ImParent, lmTop, 10); 
layoutmetrics. Width. Set (lmRight, lmLeftOf, ImParent, lmRight, 40); 
layoutmetrics. Height. Set (ImBottom, ImAbove, ImParent, ImBottom, 40); 
SetChildLayoutMetrics(*MyChildWindow, layoutMetrics) ; 

To create fixed-size and fixed-position windows, set the child's right edge a 
fixed distance from parent's left edge and the child's bottom edge a fixed 
distance from the parent's top edge. In this example, both the X and Y edge 
constraints are set to 10 and both the Width and Height edge constraints 
are set to 100. 
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Example 3 



Use the following layout constraints: 

layoutmetrics.X.Set (lmLeft, lmRightOf, ImParent, lmLeft, 10); 
layoutmetrics. Y. Set (lmTop, ImBelow, ImParent, lmTop, 10); 
layoutmetrics. Width. Absolute (100) ; 
layoutmetrics. Height. Absolute (100) ; 
SetChildLayoutMetrics (*MyChildWindow, layoutMetrics) ; 

To create a fixed-size window that remains a constant distance from the 
parent's right corner, set the child's top and bottom edges a fixed distance 
(ImLayout unit or pixels) from the parent window's bottom. Also, set the 
child's left and right edges a fixed distance from the parent's right edge. In 
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this example, both the Width and the Height edge constraints are set to 10 
and the X and Y edge constraints are set to 100. In this case, the child 
window, which stays the same size, moves with the lower right corner of 
the parent. 
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Use the following layout constraints: 

layoutmetrics.X.Set(lmRight, lmLeftOf, ImParent, lmRight, 10); 
layoutmetrics.Y.Set(lmBottom, ImAbove, ImParent, ImBottom, 10); 
layoutmetrics . Width . Absolute ( 100 ) ; 
layoutmetrics. Height .Absolute (100) ; 
SetChildLayoutMetrics(*MyChildWindow, layoutMetrics) ; 

Example 4 To create a window in which the child's edges are a percentage of the 

parent's window, set the child's edges a percentage of the distance from the 
parent's edges. Specifically, the child's top and bottom edges are a 
percentage of the parent's bottom edge. The child's left and right edges are a 
percentage of the parent's right edge. 

If you resize the parent window, the child window will change size and 
origin (that is, the top and left edges will also change). 



Height 



:66% 



X=33% 



Width=66% 



Y=33% 



Use the following layout constraints: 

layoutmetrics. X. Set (lmLeft, ImPercentOf, ImParent, lmRight, 33) 
layoutmetrics. Y. Set (lmTop, ImPercentOf, ImParent, ImBottom, 33) 



246 



ObjectWindows 2.0 Reference Guide 



TLayoutWindow class 



layoutmetrics. Width. Set(lmRight, ImPercentOf, ImParent, lmRight, 66); 
layoutmetrics. Height. Set (ImBottom, ImPercentOf, ImParent, ImBottom, 66); 
SetChildLayoutMetrics (*MyChildWindow, layoutMetrics) ; 

Public constructors and destructor 

Constructor TLayoutWindow (TWindow* parent, const char far *title = 0, TModule* 

module = ) ; 

Creates a TLayoutWindow object with specified parent, window caption, 
and library ID. 

Destructor ~TLayoutWindow() ; 

Deletes variables and frees the child metrics and constraints. 

Public member functions 

GetChildLayoutMetrics BOOL GetChildLayoutMetrics (TWindow &child, TLayoutMetrics &metrics); 

Gets the layout metrics of the child window. 

See also: TLayoutMetrics: :GetChildMetrics 
Layout void Layout ( ) ; 

Causes the window to resize and position its children according to the 
specified metrics. Call Layout to implement changes that occur in the layout 
metrics. 

RemoveChildLayoutMetricS BOOL RemoveChildLayoutMetrics(TWindow &chil-d) ; 

Removes the layout metrics for a child window. 

SetChildLayoutMetriCS void SetChildLayoutMetrics (TWindow &child, TLayoutMetrics &metrics); 

Sets the metrics for the window and removes any existing ones. Set the 
metrics as shown: 

layoutMetrics->X.Absolute(lmLeft, 10); 
layoutMetrics->Y.Absolute(lmTop, 10); 

layoutMetrics->Width.Set(lmWidth, lmRightOf, GetClientWindowO , lmWidth, -40); 
layoutMetrics->Height.Set(lmHeight, lmRightOf, GetClientWindowO, lmHeight, 
-40); 

Then call SetChildLayoutMetrics to associate them with the position of the 
child window: 

SetChildLayoutMetrics (* MyChildWindow, * layoutMetrics); 



Chapter 1, Library reference 247 



TLayoutWindow class 



Protected data members 



ClientSize 



TSize ClientSize; 

Contains the size of the client area. 



Protected member functions 



EvSize 



void EvSize (UINT sizeType, TSize& size); 

Responds to a change in window size by calling Layout to resize the 
window. 



Response table entries 






Response table entry 


Member function 


EV_WM_SIZE 


EvSize 



TListBox class 



listbox.h 



Constructor 



A TListBox is an interface object that represents a corresponding list box 
element in Windows. A TListBox must be used to create a list box control in 
a parent TWindow. A TListBox can be used to facilitate communication 
between your application and the list box controls of a TDialog. TListBox's 
member functions also serve instances of its derived class, TComboBox. 
TListBox is a streamable class. 

Public constructors 

TListBox (TWindow* parent, int Id, int x, int y, int w, int h, TModule* 
module = 0) ; 

Constructs a list box object with the supplied parent window (parent) 
library ID (module), position (x, y) relative to the origin of the parent 
window's client area, width (w), and height (h). Invokes a TControl 
constructor. Adds LBSSTANDARD to the default styles for the list box to 
provide it with 

■ A border (WS_BORDER) 

■ A vertical scroll bar (WS_VSCROLL) 
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Constructor 



■ Automatic alphabetic sorting of list items (LBS_SORT) 

■ Parent window notification upon selection (LBS_NOTIFY) 

The TListBox member functions that are described as being for single- 
selection list boxes are inherited by TComboBox and can also be used by 
combo boxes. Also, these member functions return -1 for multiple-selection 
list boxes. 

See also: GetSellndex, GetSelString, SetSellndex, SetSelString 

TListBox (TWindow* parent, int resld, TModule* module = 0) 

Constructs a TListBox object to be associated with a list box control of a 
TDialog. Invokes the TControl constructor with similar parameters. The 
module parameter must correspond to a list box resource that you define. 

See also: TControl::TControl 



Public member functions 



AddString 



ClearList 



DeleteString 



DirectoryList 
FindExactString 



virtual int AddString (const char far* str); 

Adds string to the list box, returning its position in the list (0 is the first 
position). Returns a negative value if an error occurs. The list items are 
automatically sorted unless the style LBS_SORT is removed from the list 
box object's Attr.Style data member before creation. 

See also: TListBox: -.DeleteString, TListBox: -Insert String 

inline virtual void ClearList (); 
Clears all items in the list. 

virtual int inline DeleteString (int index); 

Deletes the item in the list at the position (starting at 0) supplied in index. 
DeleteString returns the number of remaining list items, or a negative value 
if an error occurs. 

See also: TListBox:: AddString, TListBox: :InsertString 

virtual int inline DirectoryList (UINT a'ttrs, const char far* fileSpec) 
Adds a list of file names to a list box. 

int FindExactString (const char far* str, int searchlndex) const; 

Starting at the line number passed in searchlndex, searches the list box for an 
exact match with the string str. If a match is not found after the last string 
has been compared, the search continues from the beginning of the list until 
a match has been found or until the list has been completely traversed. 
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FindString 



GetCaretlndex 



GetCount 



Searches from the beginning of the list when -1 is supplied as searchlndex. 
Returns the index of the first string found if successful, a negative value if 
an error occurs. 

See also: TListBox: :AddString, TListBox: :DeleteString 

virtual int inline FindString (const char far* str, int Index) const; 

Searches the list box as described under FindExactString, but looks for the 
first entry that begins with str. 

See also: TListBox:: AddString, TListBox: :DeleteString, TListBox::InsertString 

int GetCaretlndex () const; 

Returns the index of the currently focused list-box item. For single-selection 
list boxes, the return value is the index of the selected item, if one is 
selected. 

See also: TListBoxr.SetCaretlndex 

inline virtual int GetCount () const; 

Returns the number of items in the list box, or a negative value if an error 
occurs. 



GetHorizontalExtent inline int GetHorizontalExtentO const; 

Returns the number of pixels by which the list box can be scrolled 
horizontally. 



GetltemData 



GetltemHeight 



GetltemRect 



GetSel 



See also: TListBox: :SetHorizontalExtent 

inline virtual DWORD GetltemData (int index) const; 

Returns the 32-bit value of the list box item set by SetltemData. 

See also: TListBox:: SetltemData 

inline- virtual int GetltemHeight (int index) const; 

Returns the height in pixels of the specified list box items. 

See also: TListBox::SetItemHeight 

inline int GetltemRect (int. index, TRectk rect) const; 

Returns the dimensions of the rectangle that surrounds a list-box item 
currently displayed in the list-box window. 

BOOL GetSel (int index) const; 

Returns the index of the selected item in the list box. 

See also: TListBox::SetSel 
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GetSelCount int GetSelCountO const; 

Returns the number of selected items in the single- or multiple-selection list 
box or combo box. 

GetSellndex virtual int GetSellndexO const; 

For single-selection list boxes. Returns the nonnegative index (starting at 0) 
of the currently selected item, or a negative value if no item is selected. 

See also: TListBoxr.SetSellndex 

GetSelindexes i n t GetSelIndexes(int* indexes, int maxCount) const; 

For multiple-selection list boxes. Fills the indexes array with the indexes of 
up to maxCount selected strings. Returns the number of items put in indexes 
(-1 for single-selection list boxes and combo boxes). 

See also: TListBox: :SetSelIndexes 

GetSelString j_ n t GetSelString(char far* str, int maxChars) const; 

Retrieves the currently selected items, putting up to maxChars of them in 
Strings. Each entry in the Strings array should have space for maxChars 
characters and a terminating null. For single-selection list boxes, returns the 
string length, a negative value if an error occurs, or 1 if no string is selected. 
For multiple-selection list boxes, returns -1. 

See also: TListBoxr.SetSelString 

GetSelStnngs j_ n t GetSelStrings(char far** strs, int maxCount, int maxChars) const; 

Retrieves the total number of selected items for a multiselection list and 
copies them into the buffer, str is an array of pointers to chars. Each of the 
pointers to the buffers is of maxChars. maxCount is the size of the array. 

See also: TListBoxr.SetSelStrings 

GetStnng inline virtual int GetString(char far* str, int index) const; 

Retrieves the item at the position (starting at 0) supplied in index and 
returns it in str. GetString returns the string length, or a negative value if an 
error occurs. 

GetStrmgLen inline virtual int GetStringLen(int Index) const; 

Returns the string length (excluding the terminating NULL) of the item at 
the position index supplied in Index. Returns a negative value in the case of 
an error. 

GetToplndex inline int GetTopIndex ( ) const; 
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SetCaretlndex 



Returns the index of the first item displayed at the top of the list box. 
See also: TListBox::SetTopIndex 

InsertString virtual int InsertString (const char far* str, int index); 

Inserts str in the list box at the position supplied in index, and returns the 
item's actual position (starting at 0) in the list. A negative value is returned 
if an error occurs. The list is not resorted. If index is -1, the string is 
appended to the end of the list. 

See also: TListBox::AddString, TListBox::DeleteString, TListBox: :FindString 

int SetCaretlndex (int index, BOOL partScrollOk) ; 

Sets the focus to the item specified at index. An item that is not visible is 
scrolled into view. 

See also: TListBox: :GetCaretIndex 

inline void SetColumnWidthfint width); 

Sets the width in pixels of the items in the list box. 

void SetHorizontalExtent (int horzExtent) ; 

Sets the number of pixels by which the list box can be scrolled horizontally. 

See also: TListBoxr.GetHorizontalExtent 

inline virtual int SetItemData(int index, DWORD itemData) ; 

Sets the 32-bit value of the list box item at the specified index position. 

See also: TListBoxr.GetltemData 

inline virtual int SetltemHeight (int index, int height); 

Sets the height in pixels of the items in the list box. 

See also: TListBox: :GetItemHeight 

inline int SetSel(int index, BOOL select); 

Selects an item at the position specified in index. For multiple-selection list 
boxes. 

See also: TListBoxr.GetSel 

virtual int SetSellndex (int index) ; 

For single-selection list boxes. Forces the selection of the item at the 
position (starting at 0) supplied in index. If index is -1, the list box is cleared 
of any selection. SetSellndex returns a negative number if an error occurs. 

SetSellndexes i n t SetSelIndexes(int* indexes, int numSelections, BOOL shouldSet); 



SetColumnWidth 



SetHorizontalExtent 



SetltemData 



SetltemHeight 



SetSel 



SetSellndex 
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For multiple-selection list boxes. Selects/ deselects the strings in the 
associated list box at the indexes specified in the Indexes array. If ShouldSet 
is TRUE, the indexed strings are selected and highlighted; if ShouldSet is 
FALSE the highlight is removed and they are no longer selected. Returns 
the number of strings successfully selected or deselected (-1 for single- 
selection list boxes and combo boxes). If NumSelections is less than 0, all 
strings are selected or deselected, and a negative value is returned on 
failure. 

SetSelltemRange inline int SetSelItemRange(B00L select, int first, int last); 

Selects the range of items specified from first to last. 

SetSelString i n t SetSelString (const char far* str, int searchlndex); 

For single-selection list boxes. Forces the selection of the first item 
beginning with the text supplied in str that appears beyond the position 
(starting at 0) supplied in Searchlndex. If Searchlndex is -1, the entire list is 
searched, beginning with the first item. SetSelString returns the position of 
the newly selected item, or a negative value in the case of an error. 

SetSelStrings i n t SetSelStrings (const char far** prefixes, int numSelections, 

BOOL ShouldSet); 

For multiple-selection list boxes. Selects the strings in the associated list box 
that begin with the prefixes specified in the prefixes array. For each string 
the search begins at the beginning of the list and continues until a match is 
found or until the list has been completely traversed. If shouldSet is TRUE, 
the matched strings are selected and highlighted; if shouldSet is FALSE the 
highlight is removed from the matched strings and they are no longer 
selected. Returns the number of strings successfully selected or deselected 
(-1 for single-selection list boxes and combo boxes). If numSelections is less 
than 0, all strings are selected or deselected, and a negative value is 
returned on failure. 

SetTabStops inline BOOL SetTabStops(int numTabs, int far* tabs); 

numTabs is the number of tabstops. tabs is the array of integers representing 
the tab positions. 

SetToplndex inline int SetTopIndex(int index); 

Sets index to the first item displayed at the top of the list box. 

See also: TListBox: :GetTopIndex 

Transfer virtual WORD Transfer (void *buffer, TTransferDirection direction); 
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Transfers the items and selection(s) of the list box to or from a transfer 
buffer if tdSetData or tdGetData, respectively, is passed as the direction, 
buffer is expected to point to a pointer to a TListBoxData structure. 

Transfer, which overrides the T Window virtual member function, returns the 
size of TListBoxData (the pointer, not the structure). To retrieve the size 
without transferring data, pass tdSizeData as the direction. 

ta^- You must use a pointer in your transfer buffer to these structures. You can't 
embed copies of the structures in your transfer buffer, and you can't use 
these structures as transfer buffers. 

See also: TListBoxData, T 'Window -.-.Transfer 

Protected member functions 

GetClassName char far* GetClassNameO ; 

Returns the name of TListBox's Windows registration class, "LISTBOX." 



TListBoxData struct 



listbox.h 



A TListBoxData is a structure that is used to transfer the contents of a list 
box. 

Public data members 



ItemDatas 



SelCount 



Sellndices 



SelStrings 



Strings 



TDwordArray* ItemDatas; 

Contains all item data DWORD for each item in the list box. 

int SelCount; 

Holds the number of selected items. 

TIntArray* Sellndices 

Contains the indexes of all the selected strings in a multiple-selection list 
box. 

TStringArray* SelStrings; 

Pointer to an array of the strings to select when data is transferred into the 
list box. When data is transferred out of the list box, SelStrings returns the 
current selection(s). 

TStringArray* Strings; 



254 



ObjectWindows 2.0 Reference Guide 



TListBoxData struct 



Pointer to an array of strings to be transferred into a TListBox. 



Public constructors and destructor 



Constructor 



Destructor 



TListBoxData () ; 

Constructs Strings and SelStrings. Initializes SelCount to 0. 

-TListBoxData () ; 

Deletes the space allocated for Strings and SelStrings. 



Public member functions 



AddString 



AddStringltem 



GetSelString 



void AddString (const char *str, BOOL isSelected = FALSE); 

Adds the specified string to Strings. If IsSelected is TRUE, adds the string to 
SelStrings and increments SelCount: 

void AddStringltem (const char* str, DWORD itemData, 
BOOL isSelected = FALSE) ) ; 

Adds a string to the Strings array, optionally selects it, and adds item data 
to the ItemDatas array. 



void GetSelString (char far* buffer, int bufferSize, int index 



const; 



Locates the string at the specified index in SelStrings and copies it into buffer. 
bufferSize includes the terminating NULL. 



GetSelStringLength int GetSelStringLength(int index 



const ; 



ResetSelections 



Select 



SelectString 



Returns the length (excluding the terminating NULL) of the string at the 
specified index in SelStrings. 

void ResetSelections (); 

Removes all strings from SelStrings and sets SelCount to 0. 

void Select (int index); 

Selects the string at the given index. 

void SelectString (const char far* str); 

Adds str to SelStrings and increments SelCount. 
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TListView class 



TListView class 



listview.h 



Derived from TListBox and TView, TListView provides views for list boxes. 
See TView for a description of view functions and TListBox for listbox 
functions. 



Public constructors and destructor 



Constructor 



Destructor 



TListView (TDocument& doc, TWindow* parent = 0); 

Creates a TListView object associated with the specified document and 
parent window. Sets Attr.AccelTable to IDA_LISTVIEW to identify the edit 
view. Sets Attr. Style to WS_HSCROLL I LBS_NOINTEGRALHEIGHT. 
Sets TView: :ViewMenu to the new TMenuDescr for this view. 

-TListView () ; 

After checking to see if there is an open view, this destructor destroys the 
TListView object. 

Public data member 



DirtyFlag 



BOOL DirtyFlag; 

Is nonzero if the data in the list view has been changed; otherwise, is 0. 



Public member functions 



CanClose 



Create 



GetViewName 



inline BOOL CanClose () ; 

Checks to see if all child views can be closed before closing the current 
view. If any child returns 0, CanClose returns and aborts the process. If all 
children return nonzero, it calls TDocManagerr.FlushDoc. 

See also: TView ::CanClose, TDocManagerr.FlushDoc 

virtual BOOL Create ( ) ; 

Overrides TWindow: -.Create and calls TEditSearch: -.Create to create the view's 
window. Calls GetDocPath to determine if the file is new or already has 
data. If there is data, calls LoadData to add the data to the view. If the view's 
window can't be created, Create throws a TXInvalidWindow exception. 

inline LPCSTR GetViewNameO; 
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Overrides TView's virtual function and returns the descriptive name of the 
class (StaticName). 

See also: TViewr.GetViewName 

GetWindOW inline TWindow* GetWindowO; 

Overrides TView's virtual function and returns the list view object as a 
TWindozv. 

See also: TViewr.Get Window 

SetDocTitle inline BOOL SetDocTitle(LPCSTR docname, int index); 

Overrides TView's virtual function and stores the document title. This name 
is forwarded up the parent chain until a TFrameWindow object accepts the 
data and displays it in its caption. 

See also: TView:: SetDocTitle 

StaticName inline static LPCSTR StaticName () ; 

Overrides TView's function and returns a constant string, "ListView." This 
information is displayed in the user interface selection box. 

See also: TViewr.GetViewName 



Protected data members 



MaxWidth 



Origin 



int MaxWidth; 

Holds the maximum horizontal extent (the number of pixels by which the 
view can be scrolled horizontally). 

long Origin; 

Holds the file position at the beginning of the display. 



Protected member functions 



CmEditAdd 



CmEditCopy 



void CmEditAddO; 

Automatically responds to CMJLISTADD message by getting the length of 
the input string and calling InsertString to insert the text string into the list 
view. Sets the data member DirtyFlag to TRUE. 

void CmEditCopy ( ) ; 
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Automatically responds to a menu selection with a menu ID of 
CM_EDITCOPY by calling TListBox: -.Copy to copy the selected text to the 
Clipboard. 

CmEditClear void CmEditClearO ; 

Automatically responds to a menu selection with a menu ID of 
CM_EDITCLEAR by calling TListBox: -.Clear to clear the list view. 

CmEditCut void CmEditCutO; 

Automatically responds to a menu selection with a menu ID of 
CM_EDITCUT by calling CmEditCopy and CmEditDelete to delete a text 
string from the list view. Sets the data member Dirty Flag to TRUE. 

CmEditDelete void CmEditDelete (); 

Automatically responds to a menu selection with a menu ID of 
CM_EDITDELETE by calling TLIstBox::DeleteSelection. 

CmEditltem void CmEditltemO ; 

Automatically responds to a CM_LISTEDIT message by getting the input 
text and inserting into the list view. Sets the Dirty Flag to nonzero to indicate 
that the view has been changed and not saved. 

CmEditPaste void CmEditPasteO; 

Automatically responds to a menu selection with a menu ID of 
CM_EDITPASTE by calling TListBox: -.Paste. 

CmEditUndO vo id CmEditUndo ( ) ; 

Automatically responds to a menu selection with a menu ID of 
CM_EDITUNDO by calling TListBox: -.Undo. 

CmSelChange voidCmSelChangeO ; 

Automatically responds to a LBN_SELCHANGE message (which indicates 
that the contents of the list view have changed) by calling DefaultProcessing. 

EvGetDlgCode ui NT EvGetDlgCode ( ) ; 

Overrides TWindow's response to a WM_GETDLGCODE message (an input 
procedure associated with a control that isn't a check box) by calling 
DefaultProcessing. 

LoadData . B 00L LoadData(int top, int sel); 

Reads the view from the stream and closes the file. Returns TRUE if the 
view was successfully loaded. 
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SetExtent 



VnCommit 



VnDocClosed 



VnlsDirty 



VnlsWindow 



VnRevert 



Throws an xmsg exception and displays the error message "TListView 
initial read error" if the file can't be read. Returns FALSE if the view can't 
be loaded. 

void SetExtent (LPSTR str) ; 

Sets the maximum horizontal extent for the list view window. 

BOOL VnCommit (BOOL force); 

VnCommit commits changes made in the view to the document. If force is 
nonzero, all data, even if it's unchanged, is saved to the document. 

See also: TListViewr.vnRevert, vnxxxx view notification constants 

BOOL VnDocClosed (int omode) ; 

VnDocClosed indicates that the document has been closed. 

See also: vnxxxx view notification constants 

inline BOOL VnlsDirty (); 

VnlsDirty returns nonzero if changes made to the data in the view have not 
been saved to the document; otherwise, returns 0. 

See also: vnxxxx view notification constants 

inline BOOL VnlsWindow (HWND hWnd) ; 

VnlsWindow returns nonzero if the window's handle passed in hWnd is the 
same as that of the view's display window. 

See also: vnxxxx view notification constants 

BOOL VnRevert (BOOL clear); 

VnRevert indicates if changes made to the view should be erased, and the 
data from the document should be restored to the view. If clear is nonzero, 
the data is cleared instead of restored to the view. 

See also: TListView ::vnCommit 



Response table entry 



Entry 



Member function 



EV_COMMAND(CM 
EV_COMMAND(CM 
EV_COMMAND(CM 
EV_COMMAND(CM. 
EV_COMMAND(CM. 



LISTUNDO, CmEditUndo) 
LISTCUT, CmEditCut) 
USTCOPY, CmEditCopy) 
USTPASTE, CmEditPaste) 
LISTCLEAR, CmEditClear) 



CmEditUndo 

CmEditcut 

CmEditCopy 

CmEditPaste 

CmEditClear 
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Entry 


Member function 


EV_COMMAND(CM_LISTDELETE,CmEditDelete) 


CmEditDelete 


EV_COMMAND(CM_LISTADD,CmEditAdd) 


CmEditAdd 


EV_COMMAND(CM LISTEDIT, CmEditltem) 


CmEditltem 


EV WM_GETDLGCODE 


EvGetDlgCode 


EV_NOTIFY_AT_CHILD(LBN_DBLCLK, CmEditltem) 


CmEditltem 


EV NOTIFY AT CHILD(LBN SELCHANGE, CmSelChange) 


CmSelchange 


EV VN DOCCLOSED 


VnDocClosed 


EV VN ISWINDOW 


VnlsWindow 


EV_VN_ISDIRTY 


VnlsDirty 


EV VN COMMIT 


VnCommit 


EV_VN_REVERT 


VnRevert 



TLookupValidator class 



validate.h 



A streamable class, TLookupValidator compares the string typed by a user 
with a list of acceptable values. TLookupValidator is an abstract validator 
type from which you can derive useful lookup validators. You will never 
create an instance of TLookupValidator. When you create a lookup validator 
type, you need to specify a list of valid items and override the Lookup 
method to return TRUE only if the user input matches an item in that list. 
One example of a working descendant of TLookupValidator is 
TStringLookupValidator. 

Public constructors 



Constructor TLookupValidator ( ) ; 

Constructs a TLookupValidator object. 

Public member functions 



IsValid 



Lookup 



BOOL IsValid (const char far* str); 

IsValid overrides TValidator's virtual function and calls Lookup to find the 
string str in the list of valid input items. IsValid returns TRUE if Lookup 
returns TRUE, meaning Lookup found str in its list; otherwise, it returns 
FALSE. 

virtual BOOL Lookup(const char far* str); 

Searches for the string str in the list of valid entries and returns TRUE if it 
finds str; otherwise, returns FALSE. TLookupValidator's Lookup is an abstract 
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method that always returns FALSE. Descendant lookup validator types 
must override Lookup to perform a search based on the actual list of 
acceptable items. 



TMDIChild class 



mdichild.h 



TMDIChild defines the basic behavior of all MDI child windows. To be used 
as MDI children, classes must be derived from TMDIChild. MDI children 
can inherit keyboard navigation, focus handling, and icon support from 
TFrameWindow. TMDIChild is a streamable class. 

Public constructors and destructor 



Constructor 



Constructor 



Destructor 



TMDIChild (TMDIClient kparent, const char far *title = 
TWindow *clientWnd = 0, BOOL shrinkToClient 
module = 0) ; 



FALSE, TModule* 



Creates an MDI child window of the MDI client window specified by 
parent, using the specified title, client window {clientWnd) and instance 
(inst). Invokes the TFrameWindow base class constructor, supplying parent, 
title, clientWnd, inst, and indicating that the child window is not to be 
resized to fit. Invokes the TWindow base class constructor, specifying 
parent, title, and inst. The window attributes are then adjusted to include 
WS_VISIBLE, WS_CHILD, WS_CLIPSIBLINGS, WS_CLIPCHILDREN, 
WS_SYSMENU, WS_CAPTION, WS.THICKFRAME, WSJviINIMIZEBOX, 
and WS_MAXIMIZEBOX. The dimensions of the window are set to the 
Windows default values. 

TMDIChild (HWND hWnd, TModule* module = 0); 

Creates an MDI child window object from a preexisting window, specified 
by hWnd. The base class TFrameWindow constructor is invoked, specifying 
this hWnd, as well as the specified inst. The base class TWindow constructor 
is invoked, supplying the hWnd and inst parameters. 

-TMDIChild (); ■ . 

Destructs the MDI child window object. 



Public member functions 



Destroy 



void Destroy (int 
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Destroys the interface element associated with the TMDIChild. Calls 
EnableAutoCreate for each window in the child list so that the children are 
also re-created when the parent window is re-created. 

See also: TWindozv::EnableAutoCreate 

PrePrOCessMsg B 00L PreProcessMsg (MSG &) ; 

Performs preprocessing of window messages for the MDI child window. If 
keyboard handling is enabled the parent client window's 
TMDIClient: -.PreProcessMsg member function is called to preprocess 
messages. In this case, the return value is TRUE. Otherwise, 
TFrameWindow::PreProcessMsg is called and its return value becomes the 
return value of this member function. 

See also: TMDIClient::PreProcessMsg, TFrameWindozv::PreprocessMsg 

Protected member functions 

DefWindowProc LRESULT DefWindowProc (UINT msg, WPARAM wParam, LPARAM lParam) ; 

Overrides T 'Window -.DefWindowProc and calls the Windows API function 
::DefMDIChildProc that provides default processing for any incoming 
message the MDI child window does not process. 

See also: r.DefMDIChildProc, TWindow.-.DefWindowProc 

EvMDIActivate void EvMDIActivate(BOOL activate, HWND hWndActivated, 

HMD hWndDeactivated) ; 

Instructs a client window to activate or deactivate an MDI child window 
and then sends a message to the child window being activated and the 
child window being deactivated. 

PerformCreate void PerformCreate (int menuOrld); 

Creates the interface element associated with the MDI child window. If no 
parent window has been specified, PerformCreate throws a 
T Window: :TXInvalidChildWindow exception. Otherwise, it calls 
r.SendMessage to notify the parent MDI client window to create the child 
window's interface element. The supplied menuOrld parameter is ignored 
because MDI child windows cannot have menus. 

See also: Windows message WM_MDICREATE, ::SendMessage 
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Response table entries 



TMDIChild class 



Response table entry 



Member function 



EV WM MDIACTIVATE 



EvMDIActivate 



TMDICIient class 



mdi.h 



Multiple Document Interface (MDI) client windows (represented by a 
TMDICIient object) manage the MDI child windows of a TMDIFrame 
parent. TMDICIient is a streamable class. 

Public data member 



ClientAttr 



LPCLIENTCREATESTRUCT ClientAttr; 

ClientAttr holds a pointer to a structure of the MDI client window's 
attributes. 



Public constructors and destructor 



Constructor 



Destructor 



TMDICIient (TModule* module = 0); • 

Creates an MDI client window object by invoking the base class TWindozv 
constructor, passing it a null parent window, a null title, and the specified 
library ID. Sets Attr.Id to the default client window identifier 
(IDW_MDICLIENT) and sets Attr. Style to include 
MDIS_ALLCHILDSTYLES, WS_GROUP, WS_TABSTOP, 
WS_CLIPCHILDREN, WS_VSCROLL, and WS_HSCROLL. Initializes the 
ClientAttr data member, setting its idFirstChild member to 
IDW_FIRSTMDICHILD. 

See also: TWindowr.TWindozv 

-TMDICIient (); 

Frees the ClientAttr structure. 

See also: TWindow::~TWindow 



Public member functions 



Arrangelcons 



inline virtual void Arrangelcons 
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TMDICIient class 



CascadeChildren 



CloseChildren 



Create 



CreateChild 



GetActiveMDIChild 



InitChild 



Arranges the MDI child window icons at the bottom of the MDI client 
window. 

inline virtual void CascadeChildren () ; 

Sizes and arranges all of the non-iconized MDI child windows within the 
MDI client window. The children are overlapped, although each title bar is 
visible. 

virtual BOOL CloseChildren () ; 

First calls CanClose on each of the MDI child windows owned by this MDI 
client. Returns TRUE if all MDI children are closed; otherwise returns 
FALSE. 

See also: TWindow::CanClose 

BOOL Create ( ) ; 

Creates the interface element associated with the MDI client window. Calls 
T 'Window: -.Create after first setting the child window menu in Client Attr to 
the parent frame window's child menu. 

See also: TWindow::Create, TFrameWindow::ChildMenuPos, 
TFrameWindow::GetMenu 

virtual TWindow* CreateChild () ; 

Overrides member function defined by TWindow. Constructs and creates a 
new MDI child window by calling InitChild and Create. Returns a pointer to 
the new MDI child window. 

See also: TMDICIient ■.•.InitChild, TModule::Make Window, TWindow: -.Create 

TMDIChild *GetActiveMDIChild() ; 

GetActiveMDIChild points to the TMDIClienfs active MDI child window. 
GetActiveMDIChild is set by the child in its EvMDIActivate message 
response member function. TMDIClienfs constructors initialize 

GetActiveChild. 

inline virtual TMDIChild *lnitChild() ; 

Constructs an instance of TWindow as an MDI child window and returns a 
pointer to it. Children must be created with MDI client as the parent 
window. Redefine this member function in your derived MDI window 
class to construct an instance of a derived MDI child class. For example, 

PTWindowsObject TMyMDIClient: : InitChild () 



{ 



return new TMyMDIChild (this, 
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See also: TMDIClientr.CreateChild 

PreProcessMsg BOOL PreProcessMsg(MSG &msg); 

If the specified msg is one of WMJCEYDOWN or WM_SYSKEYDOWN, 
then the Windows TranslateMDISysAccel function is called to translate 
keyboard accelerators for the MDI client. 

See also: T Window: :PreProcessMsg 

TileChildren inline virtual void TileChildren(int tile = MDITILEJ/ERTICAL) ; 

Sizes and arranges all of the non-iconized MDI child windows within the 
MDI client window. The children fill up the entire client area without 
overlapping. 

Protected member functions 



CmArrangelcons 



inline void CmArrangelcons () ; 

Calls Arrangelcons in response to a menu selection with an ID of 
CM ARRANGEICONS. 



See also: TMDICIient:: Arrangelcons 
CmCascadeChildren inline void CmCascadeChildrenO; 

Calls CascadeChildren in response to a menu selection with an ID of 
CM_CASCADECHILDREN. 

See also: TMDIClientr.CascadeChildren 

CmChildActionEnable void CmChildActionEnable(TCommandEnabler& commandEnabler) ; 

If there are MDI child windows, CmChildActionEnalbe enables any one of 
the child window action menu items. 



CmCloseChiidren 



CmCreateChild 



CmTileChildren 



inline void GmCloseChildren(); 

Calls CloseChildren in response to a menu selection with an ID of 
CM_CLOSECHILDREN. 

See also: TMDICIient: -.CloseChildren 

inline void CmCreateChild () ; 

Calls CreateChild to produce a new child window in response to a menu 
selection with a menu ID of CM_CREATECHILD. 

See also: TMDICIient: -.CreateChild 

inline void CmTileChildren () ; 
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Calls TileChildren in response to a menu selection with an ID of 
CM_TILECHILDREN. 

See also: TMDICIient: -.TileChildren 

CmTileChildrenHoriz i n ii ne V oid CmTileChildrenHorizO ; 

Calls TileChildren in response to a menu selection with an ID of 
CM_TILECHILDREN and passes MDI child title flag as 
MDITILE_HORIZONTAL. 

EvMDICreate LRESULT EvMDICreate (MDICREATESTRUCT far& createStruct); 

Intercepts the WM_MDICREATE message sent when MDI child windows 
are created, and, if the client's style includes MDIS_ALLCHILDSTYLES, 
and the child window's specified style is 0, then changes the child window 
style attributes to WS_VISIBLE, WS_CHILD, WS_CLIPSIBLINGS, 
WS_CLIPCHILDREN, WS_SYSMENU, WS_CAPTION, 
WS_THICKFRAME, WS_MINIMIZEBOX, and WS_MAXIMIZEBOX. Then 
returns the value of calling DefaultProcessing. 

See also: TWindozv "DefaultProcessing 

GetClaSSName C har far *GetClassName() ; 

Returns TMDIClient's Windows registration class name, "MDICLIENT." 



Response table entries 



Response table entry 



Member function 



EV_COMMAND (CM_ARRANGEICONS, CmArrangelcons) 
EV_COMMAND (CM_CASCADECHILDREN, CmCascadeChildren) 
EV_COMMAND (CM_CLOSECHILDREN, CmCloseChildren) 
EV_COMMAND (CM_CREATECHILD, CmCreateChild) 
EV_COMMAND (CM_TILECHILDREN, CmTileChildren) 
EV_COMMAND(CM_TILECHILDRENHORIZ,CmTileChildrenHoriz) 
EV_COMMAND_ENABLE(CM_TILECHILDREN, CmChildActionEnable) 
EV_COMMAND_ENABLE(CM_CASCADECHILDREN,CmChildActionEnable) 
EV_COMMAND_ENABLE(CM_ARRANGEICONS, CmChildActionEnable) 
EV_COMMAND_ENABLE(CM_CLOSECHILDREN, CmChildActionEnable) 
EV WM MDICREATE 



CmArrangelcons 

CmCascadeChildren 

CmCloseChildren 

CmCreateChild 

CmTileChildren 

CmTileChildrenHoriz 

CmChildActionEnable 

CmChildActionEnable 

CmChildActionEnable 

CmChildActionEnalbe 

EvMDICreate 



266 



ObjectWindows 2.0 Reference Guide 



TMDIFrame class 



TMDIFrame class 



mdi.h 



Multiple Document Interface (MDI) frame windows, represented by 
TMDIFrame, are overlapped windows that serve as main windows of MDI- 
compliant applications. TMDIFrame objects automatically handle the 
creation and initialization of an MDI client "window" (represented by a 
TMDIClient object) required by Windows. TMDIFrame sets window style 
WS_CLIPCHILDREN by default so that minimal flicker occurs when the 
MDI frame erases its background and the backgrounds of its children. 
TMDIFrame is a streamable class. 

Because TMDIFrame is derived from TFrameWindow, it inherits keyboard 
navigation. As a result, all children of the MDI frame acquire keyboard 
navigation. Howver, it's best to enable keyboard navigation only for those 
children who require it. 

Public data members 

ChildMenuPos i nt ChildMenuPos; 

ChildMenuPos contains the position in the MDI window's top-level menu of 
the child window submenu. The zero position is at top left. 

Public constructors 

Constructor TMDIFrame (const char far *title, TResId menuResId, 

TMDIClient &clientWnd = *new TMDIClient, TModule* module = 0) ; 

Constructs an MDI frame window object using the caption (title) and 
resource ID (menuResId). If no client window is specified (client Wnd), then 
an instance of TMDIClient is created automatically and used as the client 
window of the frame. The supplied library ID (module) is passed to the 
TFrameWindow constructor along with a null parent window pointer, 
caption, client window, and a flag indicating that the client window is not 
to be resized to fit. The TWindow constructor is also invoked; it passes the 
supplied caption and library ID, as well as a null parent window pointer. 
Then the child menu position is initialized to be the leftmost menu item, 
and the supplied menu resource ID is used in a call to AssignMenu. 

See also: TMDIClient::TMDIClient, TFrameWindow <: .-TFrameWindow, 
TWindow ::T Window, TFrameWindow:: AssignMenu 

Constructor TMDIFrame (HWND hwindow, HWND clientHWnd, TModule* module = 0); 
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Constructs an MDI frame window using an already created non- 
ObjectWindows window. Invokes the TFrameWindow and T Window 
constructors, passing in the window handle (hWindow) and library ID 
(module). Initializes the child menu position to the leftmost menu item, and 
constructs a TMDIClient object that corresponds to the supplied 
clientHWnd. 

See also: TFrameWindowr.TFrameWindow, T Window ::T Window, 
TMDIClientr.TMDIClient 

Public member functions 



GetClientWindow 



SetMenu 



DefWindowProc 



inline TMDIClient *GetClientWindow (); 
Returns a pointer to the MDI client window. 
See also: TFrameWindow: -.GetClientWindow 

BOOL SetMenu (HMENU) ; 

Looks for the MDI submenu in the new menu bar and updates 
ChildMenuPos if the menu is found. Searches for the MDI child menu in the 
new menu bar and updates the child menu position (ChildMenuPos) with 
the specified menu index. Then sends the client window an 
WM_MDISETMENU message to set the new menu and invokes 
TWindow::DrawMenuBar to redraw the menu. Returns FALSE if the MDI 
client indicates that there was no previous menu; otherwise returns TRUE. 

See also: TWindow.-.DrawMenuBar 

Protected member function 

LRESULT DefWindowProc (UINT message, WPARAM wParam, LPARAM lParam) ; 

Overrides TWindow.DefWindowProc and calls the Windows API function 
::DefFrameProc that provides default processing for any incoming message 
the MDI frame window does not process. 

See also: r.DefFrameProc, -.-.DefWindowProc 



Response table entries 



The TMDIFrame response table has no entries. 
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TMeasurementUnits enum 



layoutco.h 



enum TMeasurementUnits; 

Used by the TLayoutConstraint struct, TMeasurementUnits enumerates the 
measurement units (ImPixels or ImLayoutUnits) that control the dimension 
of the window. These can be either pixels or layout units that are obtained 
by dividing the font height into eight vertical and eight horizontal 
segments. 

See also: TLayoutConstraint struct 



TMemoryDC class 



dc.h 



A DC class derived from TDC, TMemoryDC provides access to a memory 
DC. 



Public constructors 



Constructor 



Constructor 



TMemoryDC ( ) ; 

Default constructor for a memory DC object. 

See also: TDC::TDC 

TMemoryDC (const TDC& DC); 

Creates a memory DC object compatible with the given DC argument. 

See also: TDCr.TDC 



Public member functions 



RestoreBitmap inline void RestoreBitmapO; 

Restores the originally selected bitmap object for this DC. 

See also: TDC::RestoreObjects 

RestoreObjectS inline void RestoreObjects(); 

Restores the originally selected brush, pen, font, palette, and bitmap objects 
for this DC. 

See also: TDCr.RestoreObjects, TMemoryDC: -.RestoreBitmap 
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SelectObject inline void SelectObject (const TBrushk brush); 

inline void SelectObject (const TPen& pen); 
inline void SelectObject (const TFont& font); 
inline void SelectObject (const TPalettek palette, BOOL 

forceBackground=FALSE) ) ; 
void SelectObject (const TBitmapk bitmap); 

Selects the given GDI object into this DC. 

See also: TDC::SelectObject, TMemoryDCr.RestoreObjects, 
TMemoryDC: :RestoreBitmap 

Protected data member 



OrgBitmap 



HBITMAP OrgBitmap; 

The original bitmap selected into this DC. 

See also: TMemoryDC::SelectObject, TMemoryDC: :RestoreBitmap 



TMenu class 



menu.h 



The TMenu class encapsulates window menus. You can use TMenu member 
functions to construct, modify, query, and create menu objects. You can also 
use TMenu to add bitmaps to your menu or to specify if a menu item is 
checked or unchecked. 

Public constructors and destructor 

Constructor TMenu (TAutoDelete autoDelete = AutoDelete) ; 

Creates an empty menu and sets autoDelete, by default, so that the menu is 
automatically deleted when the object is destructed. 

Constructor TMenu ( M d wnd, TAutoDelete autoDelete = NoAutoDelete) ; 

Creates a menu object representing the window's current menu and sets 
autoDelete, by default, so that the menu is not automatically deleted when 
the object is deconstructed. 

Constructor TMenu (HMENU handle, TAutoDelete autoDelete = NoAutoDelete); 

Creates a menu object from an already loaded menu and sets autoDelete, by 
default, so the menu is not automatically deleted when the object is 
deconstructed. 
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Constructor 
Constructor 
Destructor 



AppendMenu 
AppendMenu 

CheckMenultem 
DeleteMenu 



EnableMenultem 



TMenu class 



TMenu(LPCVOID* menuTemplate) ; 

Creates a menu object from a menu template in memory. 

TMenu (HINSTANCE instance, TResId resld) ; 

Creates a menu object from a specified resource ID. 

virtual -TMenu ( ) ; 

Destroys the pop-up menu. 

Public member functions 

inline BOOL AppendMenu (UINT flags, UINT idNewItem, const TBitmap& newBmp) ; 

Adds a bitmap menu item at the end of the menu. 

inline BOOL AppendMenu (UINT flags, UINT idNewItem- = -1, 
const char far* newltem = 0); 

Adds a text menu item to the end of the menu. 

inline BOOL CheckMenultem (UINT idltem, UINT check); 
Checks or unchecks the menu item. 

inline BOOL DeleteMenu (UINT idltem, UlNT flags); 

Removes the menu item (idltem) from the menu or deletes the menu item if 
it's a pop-up menu, flags is used to identify the position of the menu item by 
its relative position in the menu (MF_BYPOSITION) or by referencing the 
handle to the top-level menu (MFJBYCOMMAND). See the Windows API 
online Help for information on these flags. 

See also: TMenu: :RemoveMenu 

inline BOOL EnableMenultem (UINT idltem, UINT enable); 



Enables or disables the menu options (MF_CHECKED, MF_GRAYED, 
MF_HELP, MF_MENUBARBREAK, MF_MENUBREAK, 
MF_OWNERDRAW, MF_POPUP) that control the appearance of the menu 
item. See the Windows API online Help for information about these flags. 

GetMenuCheckMarkDimensions inline static BOOL GetMenuCheckMarkDimensions(TSize& size); 

Gets the size of the bitmap used to display the default check mark on 
checked menu items. 

See also: TMenu::SetMenuItemBitmaps 

GetMenultemCount inline UINT GetMenuItemCount ( ) const; 
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GetMenultemID 



GetMenuState 



GetMenuString 



GetSubMenu 



InsertMenu 



InsertMenu 



IsOK 



ModifyMenu 



ModifyMenu 



operator HMENU 



Returns the number of items in a top-level or pop-up menu. 

inline UINT GetMenultemID (int posltem) const; 

Returns the ID of the menu item at the position specified by posltem. 

inline UINT GetMenuState (UINT idltem, UINT' flags) const; 

Returns the values of the flags for a menu item specified by idltem. flags is a 
combination of one or more of the Windows API MF_xxxx flags, such as 
MF_POPUP, MF_GRAYED, MFCHECKED, and so on. 

See also: ::MF_xxxx flags 

inline UINT GetMenuString (UINT idltem, char* str, int count, UINT flags) 

const; 

Returns the label (str) of the menu item (idltem). 

inline HMENU GetSubMenu (int posltem) const; 

Returns the handle of the menu specified by posltem. 

inline BOOL InsertMenu (UINT idltem, UINT flags, UINT idNewItem, 
const TBitmap& newBmp) ; 



Adds a bitmap menu item after the menu item specified in idltem. 

inline BOOL InsertMenu (UINT idltem, UINT flags, UINT idNewItem = 
const char far* newltem = 0); 



-1, 



Inserts a new text menu item or pop-up menu into the menu after the menu 
item specified in idltem. 

BOOL IsOK() const; 

Returns TRUE if the menu has a valid handle. 

inline BOOL ModifyMenu (UINT idltem, UINT flags, UINT idNewItem, 
const TBitmap& newBmp) ; 

Changes an existing menu item into a bitmap. 

inline BOOL ModifyMenu (UINT idltem, UINT flags, UINT idNewItem = -1, 
const char far* newltem = 0); 

Changes an existing menu item from the item specified in idltem to 
idNewItem. 

operator HMENU () ; 

Returns the menu's handle. 

See also: TMenu: :UINT 
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operator UINT 



RemoveMenu 



operator UINT ( ) ; 

Returns the menu's handle. This function provides compatibility with some 
Windows functions that require a UINT menu parameter. 

See also: TMenur.HMenu 

inline BOOL RemoveMenu (UINT idltem, UINT flags); 

Removes the menu item from the menu but does not delete it if it is a sub- 
menu. 

See also: 



TMenur.DeleteMenu 



SetMenultemBitmaps 



inline BOOL SetMenultemBitmaps (UINT idltem, UINT flags, 

const TBitmap* bmpUnchecked=0, 

const TBitmap* bmpChecked=0) ; 

static BOOL GetMenuCheckmarkDimensions(TSize& size 

Specifies the bitmap to be displayed when the menu item is checked and 
unchecked, idltem indicates the menu item to be associated with the bitmap. 
flags indicates how the size parameter is interpreted (whether by 
MF_BYPOSITION or by MF_BYCOMMAND). 
GetMenuCheckmarkDimensions gets the size of the bitmap. 

See also: TMenu::GetMenuCheckmarkDimensions 



Handle 



ShouldDelete 



Protected data members 

operator HMENU Handle; 
Holds the handle to the menu. 

BOOL ShouldDelete; 

ShouldDelete is set to TRUE if the destructor needs to delete the handle to 
the menu. 

See also: TMenur.DeleteMenu, TMenu: -.RemoveMenu 



TMenuDescr class 



framewin.h 



TMenuDescr describes your menu bar and its arrangement. It uses a 
resource ID to identify the menu resource and an array of count values to 
indicate the number of menus in each group on the menu bar. Actually, 
TMenuDescr's constructor simply initializes the members based on the 
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arguments passed: TFrameWindow's MergeMenu function performs the real 
work of merging the menu groups. 

For example, if your original menu looked like this: 



File Edit Search View Page Paragraph Word Window Help 



you might use the following group counts: 



Group 



Count 



Menu 



FileGroup 


1 


File 


EditGroup 


2 


Edit Search 


ContainerGroup 


1 


View 


ObjectGroup 


3 


Page Paragraph Word 


Window/Group 


1 


Window 


HelpGroup 


1 


Help 



Then invoke the constructor in this way: 

TMenuDescr (IDM_MYMENU, 1,2,1,3,1,1) 

You can build the previous menu by merging two menus. Set your 
application's frame menu bar this way: 



File View Window Help 



TMenuDescr (IDM_FRAME, 1, 0, 1, 0, 1, 1) 
and the word-processor child menu bar this way: 



Edit Search Page Paragraph Word Help 



TMenuDescr ( IDM_WPR0C , 



2, 0, 3, 0, 1) 



If no child is active, only the frame menu will be active. When the word 
processor child window becomes active, the child menu bar is merged with 
the frame menu. Every group that is in the child menu bar leaves the 
parent's group intact. The previous example interleaves every group except 
for the last group, the Help group, in which the child replaces the frame 
menu. 

By convention, the even groups (File, Container, Window) usually belong 
to the outside frame or container, and the odd groups (Edit, Object, Help) 
belong to the child or contained group. 

If a -1 is used in a group count, the merger eliminates the parent's group 
without replacing it. For example, another child menu bar, such as a 
calculator, could be added to your application in this way. 



274 



ObjectWindows 2.0 Reference Guide 



TMenuDescr class 



Edit Base Help 



TMenuDescr (IDM_WCALC, 0, 1, -1, 1, 0, 1) 

This produces a merged menu (with the View menu selection eliminated as 
a result of the -1) that looks like this: 



File Edit Base Window Help 



You could add a paint window in this way: 



Edit Bitmap Pixel Help 



TMenuDescr (IDM_WPAINT, 0, 1, 0, 2, 0, 1) 
This produces the following merged menu: 



File Edit View Bitmap Pixel Window Help 



Public data members 



Id TResId Id; 

Resource ID for the menu. 
GroupCount[NumGroups] int GroupCount[NumGroups]; 



An array of values indicating the number of pop-up menus within each 
group on the menu bar. 

See also: TMenuDescr ::TGroup enum 

Public Constructors 

Constructor TMenuDescr ( ) ; 

Default constructor for a TMenuDescr object. 

Constructor TMenuDescr (TResId id, int fg, int eg, int eg, int og, int wg, int hg) ; 

Constructs a TMenuDescr object with the specified resource ID and number 
of items in the file menu group (fg), edit menu group (eg), container menu 
group (eg), object menu group (og), window menu group (wg), and help 
menu group (hg). 
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TMenuDescr:: TGroup enum 



framewin.h 



enum TGroup Used by TMenuDescr, the TGroup enum describes the following constants 

that define the index of the entry in the GroupCount array. 



Constant 



Meaning 



FileGroup Index of the File menu group count 

EditGroup Index of the Edit menu group count 

ContainerGroup Index of the Container menu group count 

ObjectGroup Index of the Object group count 

WindowGroup Index of the Window menu group count 

HelpGroup Index of the Help menu group count 

NumGroups Total number of groups 



See also: TMenuDescr::GroupCount[NumGroups] 



TMessageBar class 



messageb.h 



Derived from TGadget Window, TMessageBar implements a message bar with 
one text gadget as wide as the window and no border. Normally positioned 
at the bottom of the window, the message bar uses the default gadget 
window font and draws a highlighted line at the top. 

Public constructors 



Constructor TMessageBar (TWindow* parent = 

TModule* module = 



i, TFont* font = new TGadgetWindowFont , 



Constructs a TMessageBar object with the gadget window font. Sets Attr.Id 
to IDW_STATUSBAR, HighlightLine to TRUE, and TTextGadget's member 
WideAsPossible to TRUE, making the text gadget as wide as the window. 

See also: TGadgetWindowFontr.TGadgetWindowFont 



Public member function 



SetHintText 



SetText 



virtual void SetHintText (const char* text) 



Sets or clears the menu hint text for the message bar. Hint text is displayed 
over all other gadgets and is used for menu and control bar button help. 



void SetText (const char* text) 
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Forwards the message in the message bar to the text gadget for formatting. 
See also: TTextGadgetr.SetText 

Protected data member 

Highlightline BOOL HighlightLine; 

Is TRUE if a highlighted line is drawn. 

Protected member functions 

GetDesiredSize void GetDesiredSize (TSize& rect) ; 

Calls TGadgetWindow's GetDesiredSize to get the size of the message bar. 
Then, if a highlighting line is drawn, adjusts the size of the message bar. 

See also: TGadgetWindowr.GetDesiredSize 

GetlnnerRect void GetlnnerRect (TRect& rect); . 

GetlnnerRect computes the rectangle inside the borders and margins of the 
message bar. 

See also: TGadget Window: -.GetlnnerRect 

PaintGadgetS void PaintGadgetS (TDC& dc, BOOL erase, TRect& rect); 

Adjusts the message bar and paints a highlight line. Then, PaintGadgetS 
either paints the hint text if any is set or calls TGadget Window: -.PaintGadgetS 
to repaint each gadget. 

See also: TGadget Window: -.PaintGadgetS 



TMetaFileDC class 



dc.h 



Derived from TDC, TMetaFileDC provides access to a DC with a metafile 
. selected for drawing. 

Constructors and destructor 

Constructor TMetaFileDC (const char far* filename = 0); 

Default constructor for TMetaFileDC objects. 
See also: TDCr.TDC 
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Constructor TMetaFileDC (const char far* filename = 0); 

Creates a TMetaFileDC object with the data in the named file. 

See also: TDC::TDC 
Destructor -TMetaFileDC (); 

Destroys this object. 



Close 



Public member function 



inline METAFILE Close (); 

Closes this metafile DC object. Sets the Handle data member to and 
returns a pointer to a new TMetaFilePict object. 

See also: ::CloseMetaFile, TMetaFilePict, r.DeleteMetaFile 



TMetaFilePict class 



metafile.h 



TMetaFilePict is a support class used with TMetaFileDC to simplify 
Windows-format metafile operations, such as playing into a DC or storing 
data on the Clipboard. 



Extent 



Protected data member 



TSize Extent; 

Holds the extent (size) of the metafile. 



Public constructors and destructor 



Constructor 



Constructor 



TMetaFilePict (METAFILE handle,- TAutoDelete autoDelete) ; 

Creates a TMetaFilePict object with Handle set to the given handle argument. 

See also: TMetaFilePict: -.Handle 

TMetaFilePict (const TClipboard& clipboard); 

Creates a TMetaFilePict object and sets Handle from the contents of the 
specified Clipboard. 
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Constructor 



Constructor 




Constructor 




Constructor 



Destructor 



See also: TClipboard, ::GetCHpBoardData, TMetaFilePict::Handle 

TMetaFilePict (const char* filename); 

Creates a TMetaFilePict object for the Windows-format metafile stored in 
the named file by calling ::GetMetaFile( filename). Handle is set from the 
return value of the ::GetMetaFile( filename) call. 

See also: ::GetMetaFile, TMetaFilePict -/.Handle 

TMetaFilePict (UINT size, const void far* data); 

Creates a TMetaFilePict object for the memory-based metafile specified by 
data by calling ::SetMetaFileBitsEx(size, data). The data buffer must hold a 
Windows-format metafile of length size bytes. Handle is set from the return 
value of the ::SetMetaFileBitsEx call. 

See also: ::SetMetaFileBitsEx, TMetaFilePict::GetMetaFileBitsEx, 
TMetaFilePict::Handle 

TMetaFilePict (HGLOBAL data); 

Creates a TMetaFilePict object for the memory-based metafile specified by , 
data by calling ::SetMetaFileBitsBetter(data). The data global memory block 
must hold a Windows-format metafile. Handle is set from the return value 
of the ::SetMetaFileBitsBetter call. 

See also: ::SetMetaFileBitsBetter, TMetaFilePictrGetMetaFileBits, 
TMetaFilePictr.Handle 

TMetaFilePict (const TMetaFilePict& orig, const char far* fileName = 0); 

Copies the Windows-format metafile, orig, to the named file by calling 
: -.Copy MetaFilei filename). If filename is (the default), the metafile is copied to 
a memory-based metafile. Handle is set from the return value of the 
r.CopyMetaFile call. 

See also: r.CopyMetaFile, TMetaFilePictr.Handle 

-TMetaFilePict () 

Destroys this object. If Handle is nonzero, the associated metafile is also 
destroyed via r.DeleteMetaFile. 

See also: r.DeleteMetaFile, TMetaFilePictr.Handle 
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Public member functions 



GetMetaFileBits 




GetMetaFileBitsEx 




IsOK 



operator 
HMETAFILEQ 



inline HANDLE GetMetaFileBitsO; 

Returns a handle to a global memory block containing this metafile as a 
collection of bits by calling ::GetMetaFileBits(Handle). The memory block can 
be used to determine the size of the metafile or to save the metafile as a file. 

See also: "GetMetaFileBits, ::SetMetaFileBits 

inline DWORD GetMetaFileBitsEx (UINT size, void* data); 

Retrieves the contents of the Windows-format metafile associated with this 
object and copies them (up to size bytes) to the data buffer. If data is nonzero 
and the call succeeds, the actual number of bytes copied is returned. If data 
is 0, a successful call returns the number of bytes required by the buffer. A 
return value of always indicates a failure. 

See also: -.-.GetMetaFileBitsEx, ::SetMetaFileBitsEx 

inline BOOL isOK() const; 

Returns TRUE if this object's Handle is nonzero, otherwise FALSE. 

See also: TMetaFilePict::Handle 

inline operator METAFILE () const; 

Type-conversion operator returning Handle. 

See also: TMetaFilePictr.Handle 



TModule class 



module.h 



ObjectWindows dynamic-link libraries (DLLs) construct an instance of 
TModule, which acts as an object-oriented stand-in for the library (DLL) 
module. TModule defines behavior shared by both library and application 
modules. ObjectWindows applications construct an instance of 
T Application, derived from TModule. TModule's constructors manage loading 
and freeing of external DLLs, and the member functions provide support 
for default error handling. 

Public data members 



IpCmdLine 



char far* IpCmdLine; 
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Module 



Status 



A null-terminated string, IpCmdLine points to a copy of the command-line 
arguments passed when the module is loaded. Notice that IpCmdLine is 
different from the WIN32 IpCmdLine in which the full path name of the 
module is appended to the command-line arguments. Whether running 
under WIN16 or WIN32, ObjectWindows TModule: -.IpCmdLine data member 
includes only the command-line arguments. Note that the run-time library 
global variables _argv*[] and _argc contain identical information for both 
WIN16 and WIN32 APIs, and that _argv[0] points to the full path name of 
the module. 

See also: T Application 

extern TModule *Module; 

Holds a global pointer to the current module. 

TStatus Status; 

Status contains the module status and is included for backward 
compatibility with ObjectWindows 1.0 applications. ObjectWindows 2.0 
instead uses exceptions to handle errors. Setting Status to any nonzero 
value will throw a TXCompatibility exception. 

See also: TXCompatibility ::MapStatusCodeToString 

Public constructors and destructor 



Constructor 



Constructor 



Constructor 



Destructor 



TModule (const char far* name, HINSTANCE Instance, const char far* 
cmdLine) ; 

Constructs a TModule object for an ObjectWindows DLL or program from 
within LibMain or WinMain. Calls InitModule to initialize hlnstance and 
cmdLine. 

TModule (const char far* name, HINSTANCE hlnstance); 

Constructs a TModule object that is an alias for an already loaded DLL or 
program with an available Hlnstance. When the TModule is destructed, the 
instance isn't automatically freed, name, which is optional, can be 0. 

TModule (const char far* name, BOOL shouldLoad = TRUE); 

Constructs a TModule object that is used as an alias for a DLL. If shouldLoad 
is TRUE, Tmodule will automatically load and free the DLL. If shouldLoad is 
FALSE, then the Hlnstance needs to be set later using InitModule. 

virtual -TModule () ;. 

Destroys a TModule object and deletes IpCmdLine. 
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Public member functions 



AccessResource 




AllocResource 




CopyCursor 




Copylcon 



Error 



Error 



inline int AccessResource (HRSRC hRsrc) const; 

Used for 16-bit applications, AccessResource finds the specified resource. 
The preferred method is to use FindResource. 

See also: TModule: -.FindResource 

inline HGLOBAL AllocResource (HRSRC hRsrc, DWORD size) const; 

Used for 16-bit applications, AllocResource loads a resource into memory. 
The preferred method is to use LoadResource. 

See also: TModule: -.LoadResource 

inline HCURSOR CopyCursor (HCURSOR hCursor) const; 

Copies the cursor specified in hCursor. The return value is a handle to the 
duplicate cursor. 

See also: TIcon class 

inline HICON Copylcon (HICON hlcon) const; 

Copylcon copies the icon specified in hlcon. The return value is a handle to 
the icon or if unsuccessful. When no longer required, the duplicate icon 
should be destroyed. 

virtual void Error (int errorCode); 

Error processes errors identified by the error value supplied in errorCode. 
Error displays the error code in a message box and asks the user if it is OK 
to continue. If the user does continue, the program might or might not be 
able to recover. If the user does not continue, the program terminates. Error 
can be overridden with another kind of exception handler. This function is 
included only for backward compatibility with ObjectWindows 1.0. If you 
are writing ObjectWindows 2.0 applications, use the following Error 
function instead. 

virtual int Error (xmsg& x, unsigned captionResId, unsigned promptResId=0) ; 

Called when fatal exceptions occur, Error takes an xmsg exception object, a 
resource ID for a message box caption, and an optional resource ID for a 
user prompt. By default, Error calls HandleGlobalException with the xmsg 
object and the strings obtained from the resources. An application (derived 
from T Application which is derived from TModule) can reimplement this 
function to provide alternative behavior. 

A non-zero status code is returned to indicate that an error condition is to 
be propagated; a zero status indicates that the condition has been handled 
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ExecDialog 



FindResource 



GetClientHandle 



GetClasslnfo 



Getlnstance 



GetlnstanceData 




GetModuleFileName 



and that it is OK to proceed. ObjectWindows uses this status code inside its 
message loop to allow the program to resume. The global error handler 
(defined in except.h), which displays the message text, is 

int _0WLFUNC HandleGlobalException(xmsg& x, char* caption, char* 

canResume) ; 

int ExecDialog (TDialog* dialog); 

Executes a dialog box. This function is included only for backward 
compatibility. Use TDialog: -.Execute instead. 

inline HRSRC FindResource (TResId id, const char far* type) const; 

Finds the resource indicated by id and type and, if successful, returns a 
handle to the specified resource. If the resource cannot be found, the return 
value is zero. The id and type parameters either point to zero-terminated 
strings or specify an integer value, type can be one of the standard resource 
types (RT_ACCELERATOR, RT_BITMAP and so on). See the Windows API 
function r.FindResource for a description of these values. 

See also: TInstance::AccessResource, TInstance::LoadResource, 
Tlnstancer.SizeOfResource 

HWND GetClientHandle (HWND hWnd); 

Gets the handle to the client window. 

inline BOOL GetGlassInfo (const char far* name, WNDCLASS far* wndclass) 

const ; 

Used particularly for subclassing, GetClasslnfo gets information about the 
window class specified in wndclass. name points to a O-terminated string 
that contains the name of the class, wndclass points to the WNDCLASS 
structure that receives information about the class. See the Windows API 
online Help for a description of this structure. If successful, GetClasslnfo 
returns nonzero. If a matching class cannot be found, GetClasslnfo returns 
zero. 

inline HINSTANCE Getlnstance () const; 

Returns the instance handle for this module. 

inline int GetlnstanceData (void* data, int len) const; 

GetlnstanceData gets data from an already running instance of an 
application, len is the size of the buffer. 

inline int GetModuleFileName (char far* buff, int maxChars); 

Returns the expanded filename (path and filename) of the file from which 
the specified module was loaded, buff points to a buffer that holds the path 
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GetModuleUsage 




GetName 



GetParentObject 



GetProcAddress 



InitModule 



IsLoaded 



LoadAccelerators 



LoadBitmap 



and file name. maxChars specifies the length of the buffer. The expanded 
filename is truncated if it exceeds this limit. GetModeFileName returns if an 
error occurs. 

See also: ::GetModuleFileName 

inline int GetModuleUsage ( ) const; 

Returns the reference count of the module, if successful. The reference 
count is incremented by one each time GetModuleUsage is called and 
decremented by one when FreeLibrary is called. 

See also: r.GetModulellsage 

inline const char far* GetName () const; 
Gets the name of the module. 
See also: ::GetName 

TWindow* GetParentObject (HWND hWndParent ) ; 

Gets a handle to the parent window. This function is included only for, 
backward compatibility with ObjectWindows 1.0. 

See also: "GetParentObject 

inline FARPROC GetProcAddress (const char far* fcnName) const; 
Gets the address of an exported procedure or function. 
See also: : -.GetProcAddress 

void InitModule (HINSTANCE Instance, const char far* cmdLine) ; 

Performs any instance initialization necessary for the module. If the module 
can't be created, a TXInvalidModule exception is thrown. 

inline BOOL IsLoaded () const; 

Returns nonzero if the instance handle is loaded. Use this function 
primarily to ensure that a given instance is loaded. 

inline HACCEL LoadAccelerators (TResId id) const; 

Loads the accelerator table resource specified by id. LoadAccelerators loads 
the table only if it has not been previously loaded. If the table has already 
been loaded, LoadAccelerators returns a handle to the loaded table. 

See also: ::Load Accelerators 

inline HBITMAP LoadBitmap (TResId id) const; 

Loads the bitmap resource specified by id. If the bitmap cannot be found, 
LoadBitmap returns 0. 
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LoadBitmap can be used to load predefined Windows bitmaps. In such 
cases, id must be one of the OBM_XXXX values (OBM_BTNCORNERS, 
OBM_BTSIZE, and so on). See the Windows API online Help for a 
description of these values. 

See also: TBitMap class, ::LoadBitmap 

LoadCursor inline HCURSOR LoadCursor(TResId id) const 

Loads the cursor resource specified by id into memory and returns a handle 
to the cursor resource. If the cursor resource cannot be found or identifies a 
resource that is not a cursor, LoadCursor returns 0. 

LoadCursor can be used to load a predefined Windows cursor if the id is one 
of the IDC_XXXX values. See the Windows API online Help for a 
description of these values. 

See also: TCursor class, r.LoadCursor 

Loadlcon inline HICON Loadlcon (const char far* name) const; 

Loads the icon resource indicated by the parameter, name, into memory. 
Loadlcon loads the icon only if it has not been previously loaded. If the icon 
resource cannot be found, Loadlcon returns 0. 

Loadlcon can be used to load a predefined Windows cursor if name points to 
one of the IDI_XXXX values. See the Windows API online Help for a 
description of these values. 

See also: TIcon class, r.Loadlcon 

LoadMenu inline HMENU LoadMenu(TResId id) const; 

Loads the menu resource indicated by id into memory. The menu resource 
is typically a collection of one or more MENUITEMTEMPLATE structures, 
which might contain one or more menu items. If the menu resource cannot 
be found, LoadMenu returns 0. 

See also: TMenu, ::LoadMenu 

LoadReSOlirce inline HGLOBAL LoadResource(HRSRC hRsrc) const; 

Loads a resource indicated by hRsrc into memory and returns a handle to 
the memory block that contains the resource. If the resource cannot be 
found, the return value is 0. The hRsrc parameter must be a handle created 
by FindResource. 

LoadResource loads the resource into memory only if it has not been 
previously loaded. If the resource has already been loaded, LoadResource 
increments the reference count by one and returns a handle to the existing 
resource. The resource remains loaded until it is discarded. 
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LoadString 



LowMemory 
MakeWindow 



operator 
HINSTANCE 



RestoreMemory 
Setlnstance 

SetResourceHandler 




SizeOfResource 



See also: ::LoadResource 

inline int LoadString (UINT id, char far* buff, int maxChars) const; 

Loads a string resource identified by id into the buffer pointed to by buff. 
maxChars indicates the size of the buffer to which the zero-terminated 
string is copied. A string longer than the length specified in maxChars is 
truncated. The return value is the number of characters copied into the 
buffer, or if the string resource does not exist. 

See also: ::LoadString 

inline BOOL LowMemory (); 

This function, which is obsolete, always returns 0. 

TWindow* MakeWindow (TWindow* win); 

This function is obsolete. Use T Window's Create function instead. 

inline operator HINSTANCE () const; 

Returns the handle of the Windows application or DLL module 
represented by this TModule. The handle must be supplied as a parameter 
to Windows when loading resources. 

inline void RestoreMemory () ; 

This function, which is obsolete, restores memory. 

void Setlnstance (HINSTANCE hlnstance); 

Sets the instance handle for this TModule. Setlnstance is used for special 
cases in which the hlnstance is not known when the module is constructed. 

inline RSRCHDLRPROC SetResourceHandler (const char far* type, RSRCHDLRPROC 

loadProc) const; 

Used for 16-bit applications, SetResourceHandler installs a callback function 
that loads resources, type points to a resource type. loadProc is the address 
of the callback procedure. If successful, SetResourceHandler returns a pointer 
to a previously installed resource handler. If no resource handler has been 
installed, SetResourceHandler returns a pointer to the default handler. This 
function is useful for handling user-defined resource types. 

inline DWORD SizeofResource(HRSRC hRsrc) const; 

Returns the size, in bytes, of the resource indicated by hRscr. The resource 
must be a resource handle created by FindResource. If the resource cannot 
be found, the return value is 0. 
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ValidWindow 



Because of alignment in the executable file, the returned size might be 
larger than the actual size of the resource. An application cannot rely on 
SizeofResource for the exact size of a resource. 

See also: TInstancer.AccessResource, TInstancer.LoadResource 

inline TWindow* ValidWindow (TWindow* win); 

This function, which is obsolete, returns a handle to the valid window. 



Protected data members 



Hlnstance 



Name 



HINSTANCE Hlnstance; ■ 

Contains the executing instance of either the Windows application or DLL 
module. The instance must be supplied as a parameter to Windows when 
loading resources. 

char far* Name; 

Holds the name of the application or DLL module. 



TModule::TXInvalidModule class 



module.h 



A nested class, TXInvalidModule describes an exception that results from an 
invalid module. A window throws this exception if it can't create a valid 
TModule object. 

Public constructors 



Constructor TXInvalidModuleO ; 

Constructs a TXInvalidModule object. 



TOpenSaveDialog class 



opensave.h 



TOpenSaveDialog is the base class for modal dialogs that let you open and 
save a file under a specified name. TOpenSaveDialog constructs a TData 
structure and passes it the TopenSaveDialog constructor. Then the dialog is 
executed (modal) or created (modeless). Upon return, the necessary fields 
are updated including an error field that contains 0, or a common dialog 
extended error. 
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TOpenSaveDialog class 



Constructor 



Public constructors 



TOpenSaveDialog (TWindow* parent, TData& data, TResID templatelD = 0, 
const char far* title = 0, TModule* module = 0.) ; 

Constructs an open save dialog box object with the supplied parent 
window, data, resource ID, title, and current module object. 



See also: TOpenSaveDialog::TData struct 



Public member functions 



GetFileTitle 



GetFileTitleLen 



inline static int GetFileTitle (const char far* fileName, 

char far* fileTitle, int fileTitleLen) 

Stores the name of the file to be saved or opened. 

inline static int GetFileTitleLen (const char far* fileName); 
Stores the length of the name of the file to be saved or opened. 



Protected data members 



Data 



ofn 



ShareViMsgld 



TData& Data; 

Stores the file name, its length, extension, filter, initial directory, default 
file-name extension, and any error messages. 

OPENFILENAME ofn; 

Contains the attributes of the file name such as length, extension, and 
directory, ofn is initialized using the fields in the TOpenSaveDialog: :TData 
class. 

See also: TOpenSaveDialog: :TData 

static UINT ShareViMsgld; 

Contains the message ID of the registered ShareViolation message. 

See also: TFileOpenSaver.TData, TOpenSave::ShareViolation 



Protected constructors 



Constructor 



TOpenSaveDialog (TWindow* parent, TData& data, TModule* module); 

Constructs a TOpenSaveDialog box object with the supplied parent, data, 
and current module object. 
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TOpenSaveDialog class 



See also: TOpenSaveDialogr.TData struct 



Protected member functions 



CmLbSelChanged 



CmOk 



DialogFunction 



DoExecute 



Init 



ShareViolation 



inline void CmLbSelChanged () ; 

Indicates that the selection state of the file name list box in the 
GetOpenFileName or GetSaveFileName dialog boxes has changed. 
CmLbSelChanged is a default handler for command messages sent by Istl or 
1st! (the file and directory list boxes, respectively). 

inline void CmOk() ; 

Responds to a click on the dialog box's OK button (with the identifier 
IDOK). Calls CloseWindow (passing IDOK). 

See also: TDialogr.CloseWindow 

BOOL DialogFunction (UINT message, WPARAM, LPARAM) ; 

Returns TRUE if a message is handled, returns ShareViMsgld if a sharing 
violation occurs, otherwise returns FALSE. 

See also: TCommonDialog::DialogFunction 

int DoExecute () =0; < 

Creates and executes a modal dialog box. 

void Init (TResID templatelD) ; 

Initializes a TOpenSaveDialog object with the current resource ID. 

virtual int ShareViolation () ; 

If a sharing violation occurs when a file is opened or saved, ShareViolation is 
called to obtain a response. The default return value is 
OFN_SHAREWARN. Other Windows API sharing violation responses are 
listed in this table: 



Constant 



Meaning 



OFN SHAREFALLTHROUGH 



OFN OFN SHARENOWARN 



OFN SHAREWARN 



Specifies that the file name can be used and that the dialog box 

should return it to the application. 

Instructs the dialog box to perform no further action with the file 

name and not to warn the user of the situation. 

This is the default response that is defined as 0. Instructs the 

dialog box to display a standard warning message. 



See also: TFileOpenSave::TData, TOpenSaver.ShareViMsgld 
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TOpenSaveDialog class 



Response table entries 



The TOpenSaveDialog response table has no entries. 



TOpenSaveDialog::TData struct 



opensave.h 



TOpenSaveDialog structure contains information about the user's file open 
or save selection. 



Public data members 



CustomFilter 



DefExt 



Error 



char* CustomFilter; 

CustomFilter stores the user-specified file filter; for example, *.CPP. 

char* DefExt; 

DefExt stores the default extension. 

.DWORD Error; 

Error contains one or more of the following CommDlgExtendedError codes: 



Constant 



Meaning 



Flags 



Constant 



CDERRJDIALOGFAILURE 
CDERRJ.OCKRESOURCEFAILURE 
CDERR_LOADRESFAILURE 
CDERR LOADSTRFAILURE 



Failed to create a dialog box. , 
Failed to lock a specified resource. 
Failed to load a specified resource. 
Failed to load a specified string. 



DWORD Flags; 

Flag contains one or more of the following Windows API constants: 
Meaning 



OFN_HIDEREADONLY 
OFN_FILEMUSTEXIST 

OFNLPATHMUSTEXIST 

OFNLNOVAUDATE 

OFN_NOCHANGEDIR 
OFNLALLOWMULTISELECT 
OFN CREATEPROMPT 



Hides the read-only check box. 

Lets the user enter only names of existing files in the File Name entry field. If an invalid 

file name is entered, a warning message is displayed. 

Lets the user enter only valid path names. If an invalid path name is entered, a warning 

message is displayed. 

Performs no check of the file name and requires the owner of a derived class to perform 

validation. 

Sets the current directory back to what it was when the dialog was initiated. 

Allows multiple selections in the File Name list box. 

Asks if the user wants to create a file that does not currently exist. 
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TOpenSaveDialog::TData struct 



Constant 



Meaning 



OFN_EXTENSIONDIFFERENT 
OFN_NOREADONLYRETURN 
OFN_NOTESTFILECREATE 

OFN_OVERWRITEPROMPT 
OFN SHAREAWARE 



OFN SHOWHELP 



Indicates the user entered a file name different from the specified in DefExt This 

message is returned to the caller. 

The returned file does not have the Read Only attribute set and is not in a write-protected 

directory. This message is returned to the caller. 

The file is created after the dialog box is closed. If the application sets this flag, there is no 

check against write protection, a full disk, an open drive door, or network protection. For 

certain network environments, this flag should be set. 

The Save As dialog box displays a message asking the user if its OK to overwrite an 

existing file. 

If this flag is set and a call to open a file fails because of a sharing violation, the error is 

ignored and the dialog box returns the given file name. If this flag is not set, the virtual 

function ShareViolation is called, which returns OFN_SHAREWARN (by default) or one of 

the following values: 

File name is returned from the dialog box. 

No further action is taken. 

User receives the standard warning message for this 

type of error. 
Shows the Help button in the dialog box. 



OFN_SHAREFALLTHROUGH 
OFN_SHARENOWARN 
OFN SHAREWARN 



FileName 



Filter 



Filterlndex 



InitialDir 



char* FileName; 

Holds the name of the file to be saved or opened. 

char* Filter; 

Filter holds the filter to use initially when displaying file names. 

int Filterlndex; 

Filterlndex indicates which filter to use initially when displaying file names. 

char* InitialDir; 

InitialDir holds the directory to use initially when displaying file names. 



Public constructors and destructor 



Constructor 



Destructor 



TData (DWORD flags=0, char* filter=0, char* customFilter=0, 
char* initialDir=0, char* defExt=0); 

Constructs a TOpenSaveDialog::TData structure. 

-TData ( ) ; 

Destructs a TOpenSaveDialog::TData structure. 

See also: r.CommDlgExtendedError, r.OpenFileName, TEditFiler.FileData 
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TOpenSaveDialog::TData struct 



Public member functions 



SetFilter void SetFilter(const char*filter, = 0); 

Makes a copy of the filter list used to display the file names. 

TOutStream class docview.h 

Derived from TStream and ostream, TOutStream is a base class used to create 
output storage streams for a document. 

Public constructors 

Constructor TOutStream (TDocumentk doc, LPCSTR name, int mode) ; 

Constructs a TOutStream object, doc refers to the document object, name is 
the user-defined name of the stream, and mode is the mode of opening the 
stream. 

See also: TInStream, opCXXX document open enum, shdocument sharing 
enum 

TPaintDC class dc.h 

A DC class derived from TWindoivDC that wraps begin and end paint calls 
for use in a WM_PAINT response function. 



Public data members 



Ps 



PAINTSTRUCT Ps; 

The paint structure associated with this TPaintDC object. 

See also: PAINSTRUCT 



Public constructors and destructor 



Constructor TPaintDC (HWND wnd) ; 



Creates a TPaintDC object with the given owned window. The data 
member Wnd is set to wnd. 
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TPaintDC class 



Destructor 



See also: TWindowDCr.Wnd, TDCr.TDC 
-TPaintDC ( ) ; 
Destroys this object. 



TPalette class 



gdiobjec.h 



TPalette is the GDI Palette class derived from TGdiObect. The TPalette 
constructors can create palettes from explicit information or indirectly from 
various color table types that are used by DIBs. 



Stocks[ ] 



Public data members 



enum TStOCkld enum TStockId{Default}; 

Enumerates the stock palette attributes. 



Protected data members 



static TPalette Stocks []; 



Note: This array no The single static array of Windows stock palettes serving all TPalette 
lonQBr Bxists Usb 

TDC::SelectStock6bject objects. The stock palette is DEFAULT_P ALETTE. 

instead. 



Public constructors 



Constructor 



Constructor 



Constructor 



TPalette (HPALETTE handle, TAutoDelete autoDelete = NoAutoDelete) ; 

Creates a TPalette object and sets the Handle data member to the given 
borrowed handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle will not be deleted when the C++ object 
is destroyed. 

See also: TGdiObject::Handle, TGdiObject::ShouldDelete 

TPalette (const TClipboardk) ; 

Creates a TPalette object with values taken from the given Clipboard. 

See also: TClipboard::GetCHpboardData 

TPalette (const TPalettek palette); 
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TPalette class 



Constructor 



Constructor 



Constructor 



Constructor 



Constructor 



This public copy constructor creates a complete copy of the given palette 
object as in 

TPalette myPalette = yourPalette; 

See also: TPalettey.GetPaletteEntries, y.CreatePalette 

TPalette (const LOGPALETTE far* logPalette); 

Creates a TPalette object from the given logPalette array. Handle is set via a 
WinAPI CreatePalette(logPalette) call. 

See also: y.CreatePalette 

TPalette (const PALETTEENTRY far* entries, int count); 

Creates a TPalette object with count entries from the given entries arrray . 

See also: y.CreatePalette 

TPalette (const BITMAPINFO far* info, UINT flags = 0); 

Win 3.0 DIB header only. Creates a TPalette object from the color table 
following the given BITMAPINFO structure. This constructor works only 
for 2-, 16-, and 256-color bitmaps. A handle is returned for other bitmaps 
including 24-bit DIBs. 

See also: y.CreatePalette 

TPalette (const BITMAPCOREINFO far* core, UINT flags = 0); 

Presentation Manager (PM) 1.x DIBs only. Creates a TPalette object from the 
color table following the given BITMAPCOREINFO structure. This 
constructor works only for 2-, 16-, and 256-color bitmaps. A handle is 
returned for other bitmaps including 24-bit DIBs. Note that every color in a 
PM 1.x table must be present because there is no Clrllsed field in the DIB 
header. 

See also: y.CreatePalette 

TPalette (const TDib& dib, UINT flags = 0)-; 

Creates a TPalette object from the given Win or PM DIB object. The flags 
argument represents the values of the Windows Pe data structure used to 
create the palette. 

See also: y.CreatePalette 
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TPalette class 



Public member functions 



GetNumEntries 



GetObject 



AnimatePalette inline void AnimatePalette(UINT start, UINT count, 

const PALETTEENTRY far* entries) ; 

Replaces entries in this logical palette from the entries array of 
PALETTEENTRY structures, start specifies the first entry to be animated, 
and count gives the number of entries to be animated. Windows maps the 
new entries into the system palette immediately. 

See also: :: Animate? alette 

GetNearestPalettelndex inline UINT GetNearestPaletteIndex(TColor color) const; 

Returns the index of the color entry that represents the best color in this 
palette to the given color. 

See also: ::GetNearestPaletteIndex, TColor 

inline UINT GetNumEntries () const; 

Returns the number of entries in this palette or if the call fails. 

See also: TGdiObjectr.GetObject 

inline BOOL GetObject (WORD far& numEntries) const; 

Finds the number of entries in this logical palette and sets the value in the 
numEntries argument. To find the entire LOGP ALETTE structure, use 
GetPaletteEntries. Returns TRUE if the call is successful; otherwise returns 
FALSE. 

See also: TGdiObjectr.GetObject, TPalette: -.GetPaletteEntries, -.-.GetObject, struct 
LOGP ALETTE 

UINT GetPaletteEntries (WORD start, WORD count, PALETTEENTRY far* entries), 
const; 

Retrieves a range of entries in this logical palette, and places them in the 
entries array, start specifies the first entry to be retrieved, and count gives 
the number of entries to be retrieved. Returns the number of entries 
actually retrieved, or if the call fails. 

See also: -.-.GetPaletteEntries, TGdiObjectr.SetPaletteEntries 

inline UINT GetPaletteEntry(WORD index, PALETTEENTRY far& entry) const; 

Retrieves the entry in this logical palette at index, and places it in the entries 
array. Returns the number of entries actually retrieved: 1 if successful or if 
the call fails. 

See also: TPalette: iSetPaletteEntry , ::GetPaletteEntry 



GetPaletteEntries 



GetPaletteEntry 
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TPalette class 



GetStock 



operator « 



operator 
HPALETTEO 



ResizePalette 



SetPaletteEntries 



SetPaletteEntry 



ToClipboard 



static TPa'lettefc GetStock (TStockld id); 

Provides access to stock Windows palette objects. Returns 
TPalette::Stocks[id] . 

See also: TPalette::Stocks[], enum TStockld. 

inline TClipboard& operator« (TClipboardk clipboard, TPalette& palette) ; 

Copies the given palette to the given clipboard argument. Returns a reference 
to the resulting Clipboard, which allows normal chaining of «. 

operator HPALETTEO const; 

Typecasting operator. Converts this palette's Handle to type HP ALETTE, 
which is the Windows data type representing the handle to a logical 
palette. 

inline BOOL ResizePalette (UINT numEntries); 

Changes the size of this logical palette to the number given by numEntries. 
Returns TRUE if the call is successful; otherwise returns FALSE. 

See also: TP alette:: AnimateP alette 

inline UINT SetPaletteEntries (WORD start, WORD count, 

const PALETTEENTRY far* entries); 

Sets the RGB color values in this palette from the entries array of 
PALETTEENTRY structures, start specifies the first entry to be animated, 
and count gives the number of entries to be animated. Returns the number 
of entries actually set, or if the call fails. 

See also: "SetPaletteEntries, TGdiObjectr.GetPaletteEntries 

inline UINT SetPaletteEntry (WORD index, const. PALETTEENTRY far& entry); 

Sets the RGB color value at index in this palette from the entry argument. 
start specifies the first entry to be animated, and count gives the number of 
entries to be animated. Returns 1 (the number of entries actually set if 
successful) or if the call fails. 

See also: : -.SetPaletteEntry, TGdiObject::GetPaletteEntry 

void ToClipboard (TClipboard& clipboard); 

Moves this palette to the target clipboard argument. If a copy is to be put on 
the Clipboard, use TP aletteimyP alette) J oCXipboardQ; to make a copy first. 
The handle in the temporary copy of the object will be moved to the 
Clipboard. ToClipboard should set delete to FALSE so that the object on the 
Clipboard is not deleted. The handle will still be available for examination. 
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TPalette class 



See also: TClipBoard::SetClipBoardData 

UnrealizeObject inline BOOL UnrealizeObject (); 

Directs the GDI to completely remap the logical palette to the system 
palette on the next RealizePalette(HDC) or TDCr.RealizePaletteO call. Returns 
TRUE if the call is successful; otherwise FALSE. 

See also: : .-UnrealizeObject, ::RealizeP alette, 

Protected member functions 



Create 



void Create (const BITMAPINFO far* info, UINT flags); 
void Create (const BITMAPCOREINFO far* core, UINT flags); 

Sets values in this palette from the given bitmap structure. These functions 
are usually called by the constructor rather than directly. 



TPaletteEntry class 



color.h 



TPaletteEntry is a support class derived from the structure 
tagPALETTEENTRY. The latter is defined as follows: 

typedef struct tagPALETTEENTRY { 

BYTE peRed; 

BYTE peGreen; 

BYTE peBlue; 

BYTE peFlags; 
} PALETTEENTRY; 

where peRed, peGreen, and peBlue specify the red, green, and blue intensity- 
values for a palette entry. 

The peFlags member can have the following values: 



Value 



Meaning 



PC_EXPLICIT Specifies that the low-order word of the logical palette entry designates a 

hardware palette index. This flag allows the application to show the 
contents of the display device palette. 

PC_NOCOLLAPSE Specifies that the color be placed in an unused entry in the system 
palette instead of being matched to an existing color in the system 
palette. If there are no unused entries in the system palette, the color is 
matched normally. Once this color is in the system palette, colors in other 
logical palettes can be matched to this color. 
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TPaletteEntry class 



Value 



Meaning 



PC_RESERVED Specifies that the logical palette entry be used for palette animation; this 

prevents other windows from matching colors to this palette entry since 
the color frequently changes. If an unused system-palette entry is 
available, this color is placed in that entry. Otherwise, the color is 
available for animation. 

TPaletteEntry is used in conjunction with the classes TPalette and TColor to 
simplify logical color-palette operations. Constructors are provided to 
create TPaletteEntry objects from explicit COLORREF and RGB values, or 
from TColor objects. 



Public constructors 



Constructor TPaletteEntry (int r, int g, int b, int f = 0); 

Creates a palette entry object with peRed, peGreen, peBlue, and peFlags set to 
r, g, b, and /, respectively. 

See also: tagPALETTEENTRY struct 

Constructor TPaletteEntry (TColor c); 

Creates a palette entry object with peRed, peGreen, peBlue, and peFlags set to 
c.RedO, c.GreenO, c.BlueO, and c.Flags, respectively. 

See also: TColorr.Red, TColor ::Green, TColorr.Blue 



TPen class 



gdiobjec.h 



TPen is derived from TGdiObject. It encapsulates the GDI pen tool. Pens can 
be constructed from explicit information or indirectly. TPen relies on the 
base destructor, -TGdiObject. 

Public data members 

enum TStOCkld enuin TStockId{Null, Black, White}; 

Enumerates the Windows stock pens. 
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TPen class 



Protected data members 



Stocks[ ] 



static class TPen Stocks []; 

The single static array of Windows stock pen objects serving all TPen 



Note: This array no 
lonosr sxists Usb 
TDC::SelectStock6bject objects. The three stock pens are NULL_PEN, BLACKJPEN, and 

instead WHITE PEN. 



Public constructors 



Constructor TPen(HPEN handle, TAutoDelete autoDelete = NoAutoDelete) ; 

Creates a TPen object and sets the Handle data member to the given 
borrowed handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle will not be deleted when the C++ object 
is destroyed. 

See also: TGdiObjectr.Handle, TGdiObjectr.ShouldDelete, r.CreatePenlndirect 

Constructor TPen (TColor color, int width=l, int style=PS_SOLID) ; 

Creates a TPen object with the given values. The width argument is in 
device units, but if set to 0, a 1-pixel width is assumed. Sets Handle via a 
Win API CreatePeh(style, width, color) call with the given default values. If 
color is black or white, width is one, and style is solid, a stock pen handle is 
returned. The values for style are listed in the following table. 



Value 



Meaning 



PS_S0LID Creates a solid pen. 

PS_DASH Creates a dashed pen. Valid only when the pen width is one or less 

in device units. 
PS_D0T Creates a dotted pen. Valid only when the pen width is one or less in 

device units. 
PS_DASHDOT Creates a pen with alternating dashes and dots. Valid only when the 

pen width is one or less in device units. 
PS_DASHDOTDOT Creates a pen with alternating dashes and double-dots. Valid only 

when the pen width is one or less in device units. 
PS_NULL Creates a null pen. 

PSJNSIDEFRAME Creates a solid pen. When this pen is used in any GDI drawing 

function that takes a bounding rectangle, the dimensions of the figure 

will be shrunk so that it fits entirely in the bounding rectangle, taking 

into account the width of the pen. 



See also: ::CreatePen, TColor 
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TPen class 



Constructor TPen (const LOGPEN far* logPen); 

Creates a TPen object from the given logPen values. Sets Handle via a Win 
API CreatePenlndirect(logPen) call. 

See also: r.CreatePenlndirect 

Constructor TPen(DWORD penStyle, DWORD width, const ■TBrushfc brush, DWORD styleCount, 

LPDWORD style); 

Creates a TPen object with the given values. Sets Handle via a Win API 
ExtCreatePen(penStyle, width, &logBrush, styleCount, style) 'call (where 
logBrush reflects the value in the given brush object). 

See also: r.ExtCreatePen 

Constructor TPen(DWORD penStyle, DWORD width, const L0GBRUSH& logBrush, 

DWORD styleCount, LPDWORD style); 

Creates a TPen object with the given values. Sets Handle via a Win API 
ExtCreatePen(penStyle, width, &logBrush, styleCount, style) call. 





Public member functions 



GetObject 



GetStock 



operator HPENQ 



inline BOOL GetObject (LOGPEN far& logPen) const; 

Retrieves information about this pen object and places it in the given 
LOGPEN structure. Returns TRUE if the call is successful, otherwise 
FALSE. 

See also: TGdiObjectr.GetObject, struct LOGPEN 

inline static TPen& GetStock (TStockld id); 

Provides access to stock Windows pen objects. Returns TPen::Stocks[id]. 

See also: TPen::Stocks[], enum TStockld 

operator HPENO const; 

Typecasting operator. Converts this pen's Handle to type HPEN (the 
Windows data type representing the handle to a logical pen). 



TPicResult enum 



validate.h 



TPicResult is the result type returned by the Picture member function of 

TPXPictureValidator. It contains one of the following types: 

prlncomplete, prEmpty, prError, prSyntax, prAmbiguous, prlncompNoFill. 
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TPicResult enum 



enum TPicResult; 

See also: TPXPictureValidator 



TPIacement enum 



gadgetwi.h 



Enumerates the placement of a gadget — either before or after another 
gadget. 

enum TPIacement;. 

See also: TGadgetWindowr.PositionGadgets 



TPoint class 



point.h 



TPoint is a support class, derived from tagPOINT. Under WIN32, the latter 
is defined as 

typedef struct tagPOINT { 

LONG x; 

LONG y; ' ■ 
} POINT; 

Under WIN16, tagPoint is defined as 

typedef struct tagPOINT { 

int x; 

int y; 
} POINT; 

TPoint encapsulates the notion of a two-dimensional point that usually 
represents a screen position. TPoint inherits two data members, the 
coordinates x and y, from tagPOINT. A TPoint object can be created from a 
pair of ints, from a point of type POINT, from a value of type SIZE, or from 
the low and high words of a DWORD value. Member functions and 
operators are provided for comparing, assigning, and manipulating points. 
Overloaded « and » operators are declared as friends of TPoint, allowing 
chained insertion and extraction of TPoint objects with streams. 

Public constructors 



Constructor 



TPoint ( ) ; 

The default TPoint constructor. 
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TPoint class 

Constructor 
Constructor 

Constructor 

Constructor 



Offset 



OffsetBy 



operators- 



operator- 



inline TPoint (int _x, int _y) ; 

Creates a TPoint object with the given coordinates. 

inline TPoint (const POINT point); 

Creates a TPoint object with x = point.x and y = point.y. 

See also: POINT 

inline TPoint (const SIZE size); 

Creates a TPoint object with x = size.cx and y = size.cy. 

See also: SIZE struct 

inline TPoint (DWORD dw) ; 

Creates a TPoint object with x = LO WORD(dw) and y = HMORD(dw)). 

Public member functions 

inline TPointk Offset (int dx, int dy) ; 

Offsets this point by the given delta arguments. This point is changed to 
(x + dx, y + dy). Returns a reference to this point. 

See also: TPointr.OffsetBy, TPoint::operator+= 

inline TPoint OffsetBy (int dx, int dy) const; 

Calculates an offset to this point using the given displacement arguments. 
Returns the point (x + dx,y + dy). This point is not changed. 

See also: TPoint::operator+, TPointr.Offset 

inline TPoint operator+( const TSize& size) const; 

Calculates an offset to this point using the given size argument as the 
displacement. Returns the point (x + size.cx, y + size.cy). This point is not 
changed. 

See also: TPointr.OffsetBy, TSize 

inline TPoint operator- (const TSizek size) const; - 
inline TSize operator- (const TPoint& point) const; 
inline TPoint operator- () const; 

The first version calculates a negative offset to this point using the given 
size argument as the displacement. Returns the point (x - size.cx, y - size.cy). 
This point is not changed. 
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TPoint class 



operator== 



operator+= 



operators 



operator!= 



operator» 



operator« 



The second version calculates a distance from this point to the point 
argument. Returns the TSize object (x - point.x, y - point.y). This point is not 
changed. 

The third version returns the point (-x, -y). This point is not changed. 

See also: TPoint::operator+,TSize 

inline BOOL operator== (const TPointk other) const; 

Returns TRUE if this point is equal to the other point; otherwise returns 
FALSE. 

See also: TPoint::operator!= 

inline TPoint& operator+= (const TSize& size) const; 

Offsets this point by the given size argument. This point is changed to 
(x + size.cx, y + size.cy). Returns a reference to this point. 

See also: TPoint: -.Offset, TPoint ::operator-=, TSize 

inline TPoint& operator-= (const TSizek size) const; 

Negatively offsets this point by the given size argument. This point is 
changed to (x - size.cx, y - size.cy). Returns a reference to this point. 

See also: TPointr.Offset, TPoint: -.operator ■+=, TSize 

inline BOOL operator! = (const TPoint& other) const; 

Returns FALSE if this point is equal to the other point; otherwise returns 
TRUE. 

See also: TPoint::operator== 

Friend functions 

friend inline ipstream& operator>>(ipstream& is, TPointk p) const; 

Extracts a TPoint object from is, the given input stream, and copies it to p. 
Returns a reference to the resulting stream, allowing the usual chaining of 
» operations. 

See also: TPoint friend operator«, class ipstream 

friend inline opstreamk operator«(opstream& os, const TPoint& p) const; 

Inserts the given TPoint object, p, into the opstream, os. Returns a reference 
to the resulting stream, allowing the usual chaining of « operations. 

See also: TPoint friend operator», opstream 
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friend inline ostream& operator«(ostream& os, const TPoint& p) const; 

Formats and inserts the given TPoint object, p, into the ostream, os. The 
format is "(x,y)" . Returns a reference to the resulting stream, allowing the 
usual chaining of « operations. 

See also: TPoint friend operator», ostream 



TPointero class 



point.h 



A small utility class, TPointer, provides automatic destruction for objects 
constructed using new. TPointer is a parameterized class that holds a 
pointer of its parameterized type and that overloads operators to behave 
like an object pointer. Once a pointer is assigned to a TPointer object, it is 
eventually be deleted, either when the function exits, an exception is 
thrown, or another pointer is assigned to the same object. A TPointer object 
can be instantiated using one of the following equivalent methods: 

TPointer<SomeClass> p = new SomeClass; 
TPoi-nter<SomeClass> p(new SomeClass); 
TPointer<SomeClass> p; p = new SomeClass; 

TPointer objects must be created on the stack; they can't be created with 
new. However, when delete is called on the TPointer object, the overloaded 
delete operator actually calls delete on the internal pointer. This process 
permits explicit destruction of the object that is pointed to. (Note that an 
ampersand must be used to provide delete with a pointer; for example, 
delete &p.) 

Public constructors 



Constructor 



Constructor 



inline TPointer () : TPointerBase<T>() ; 
Default constructor in which p is initialized to 0. 
inline TPointer (T* pointer) : TPointerBase<T> (pointer) ; 
Initialized constructor where p is initialized to pointer. 



Public member functions 



operatorQ 



inline operator T* 
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The overloaded type conversion operator allows the TPointer object to be 
passed as a function argument or assigned to a variable as if it were a 
pointer. 

operators inline T* operator =(T* src); 

Assignment operator T* is assigned to p. 

operators T* operator = (const TPointer<T>& src); 

Assignment operator used when r is a const reference to TPointer of T. This 
operator saves converting if another pointer object is used. 

operator! inline int operator !(); 

Zero test operator that tests for p. 
operator- inline void operator ~(); 

Overloaded complement operator. 
operator delete inline void operator delete (void* p) ; 

Overloaded delete operator. 
T* Operator inline T* operator->() ; 

Provides access to the pointer. 



TPopupMenu class 



menu.h 



TPopupMenu creates an empty pop-up menu to add to an existing window 
or pop-up menu. See Chapter 7 in the ObjectWindows Programmer's Guide for 
more information about menu objects. 

Public constructors 

Constructor TPopupMenu (TAutoDelete autoDelete = AutoDelete); 

Constructs an empty pop-up menu. 

Public member functions 

TrackPopupMenu inline BOOL TrackPopupMenu(UINT flags, int x, int y, int rsvd, HWND wnd, 

TRect* rect = 0) ; 

Allows the application to create a pop-up menu at the specified location in 
the specified window, flags specifies a screen position and can be one of the 
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Windows API TPM_xxxx values(TPM_CENTERALIGN, 
TMP_LEFTALIGN, TPM_RIGHTALIGN, TPM_LEFTBUTTON, or 
TPM_RIGHTBUTTON). wnd is the handle to the window that receives 
messages about the menu, x specifies the horizontal position in screen 
coordinates of the left side of the menu, y species the vertical position in 
screen coordinates of the top of the menu (for example, 0,0 specifies that a 
menu's left corner is in the top left corner of the screen), red defines the area 
that the user can click without dismissing the menu. 

See also: •.•TrackPopupMenu 

inline BOOL TrackPopupMenu (UINT flags, TPointk point, int rsvd, HWND wnd, 

TRect* rect = 0); 

This function is the same as the previous TrackPopupMenu except that the x 
and y positions are specified in point. 

See also: : -.TrackPopupMenu 



TPreviewPage class 



preview.h 



TPreviewPage displays a page of a document in a print preview window. To 
obtain the information needed to display the page, TPreviewPage interacts 
with TPrintPreviewDC and TPrintout. Specifically, it creates a 
TPrintPreviewDC from the window DC provided in Paint and passes that 
TPrintPreviewDC object to TPrintout's SetPrintParams member function. 
PRINT.CPP, in your OWLAPIXPRNTPREV directory, displays the 
following sample print preview window: 



Document window 



Select Print Preview 

to display the 
Print Preview window 




306 



ObjectWindows 2.0 Reference Guide 



I KreviewKage ciass 



Public constructors 



Constructor 



Paint 



SetPageNumber 



PreviewPage(TWindow* parent, TPrintoutk printout, TPrintDCk prndc, 
TSizek printExtent, int pagenum = 1) ; 

Constructs a TPreviewPage object where parent is the parent window, 
printout is a reference to the corresponding TPrintout object, prndc is a 
reference to the TPrintPreviewDC object, printExtent is the extent (width and 
height) in logical units of the printed page, and pagenum is the number of 
the preview page. Initializes the style bits in Attr. Style so that TPreviewPage 
has the attributes of a visible child window with a thin border. Sets the 
background color of the preview page window to white. 

Public member functions 

void Paint (TDC& dc, BOOL, TRect& clip); 

Displays the page in the preview window. To determine the preview page's 
attributes (line width, and so on), Paint calls several of TPrintout's member 
functions. Then, to adjust the printer object for previewing, Paint 
determines if the page fits in the preview window or if clipping is 
necessary. Finally, Paint passes clipping and banding information to 
TPrintout's PrintPage function, which is called to display the page in the 
preview window. 

See also: TPrintout r.BeginPrinting, TPrintout::EndPrinting, 
TPrintout: -.PrintPage 

inline void SetPageNumber (int newNum); 

Sets newNum to the number of the page currently displayed in the preview 
window. 



Protected data members 



PageNum 



PrintDC 



PrintExtent 



int PageNum; 

Number of the page displayed in the preview window. 

TPrintDCk PrintDC; 

PrintDC& is a handle to the device context to use for printing. 

TSize PrintExtent; 

Contains the extent (width and height) in logical units of the page. 
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Printout 



TPrintoutk Printout; 

Holds a reference to the TPrintout object. 



Protected member functions 



EvSize 



void EvSize(UINT sizeType, TSize& size); 

Invalidates the entire window when the size of the page displayed in the 
preview window changes. 

See also: TWindow::EvSize 

Response table entries 



Response table entry 



Member function 



EV WM SIZE 



EvSize 



TPrintDC class 



dc.h 



Derived from TDC, TPrintDC provides access to a printer. 

Public constructors 

Constructor TPrintDC (HDC handle, TAutoDelete autoDelete = NoAutoDelete) ; 

Creates a TPrint object for the DC given by handle. 

See also: TAutoDelete, TDCr.TDC 

Constructor TPrintDC (const char far* driver, const char far* device, const char far* 

output, const DEVMODE far* initData) ; 

Creates a TPrint object given print driver, device, output, and data from the 
DEVMODE structure. 



Public member functions 



AbortDoc 



inline int AbortDoc (); 
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Bandlnfo 



DeviceCapabilities 



Aborts the current print job on this printer and erases everything drawn 
since the last call to StartDoc. AbortDoc calls the user-defined function set 
with TPrintDC::SetAbortProc() to abort a print job because of error or user 
intervention. TPrintDC::EndDoc should be used to terminate a successfully- 
completed print job. 

If successful, AbortDoc returns a positive or zero value; otherwise a 
negative value is returned. 

Note that for pre-Win 3.1 applications, documents are aborted by calling 
EscapeO with escape value ABORTDOC. For Win 3.1 and later, this escape 
method is superseded by the :: AbortDoc function. TPrintDC:: AbortDoc 
automatically selects the appropriate call. 

See also: r.AbortDoc, TPrintDC: :EndDoc, TPrintDC: :SetAbortProc, 
TPrintDCr.Escape, ABORTDOC 

inline int Bandlnfo (TBandInfo& bandlnfo); 

Retrieves information about the banding capabilities of this device, and 
copies it to the given bandlnfo structure. Returns 1 if the call is successful; 
returns if the call fails or if this device does not support banding. 

See also: struct TBandlnfo, TPrintDCr.Escape, BANDINFO 

static DWORD DeviceCapabilities (const char far* driver, const char far* 

device, const char far* port, 
int capability, char far* output=0, 
LPDEVMODE devmode=0); 

Retrieves data about the specified capability of the named printer driver, 
device, and port, and places the results in the output char array. The driver, 
device, and port names must be zero-terminated strings. The devmode 
argument points to a DEVMODE struct. If devmode is (the default), 
DeviceCapabilities retrieves the current default initialization values for the 
specified printer driver; otherwise, it retrieves the values contained in the 
DEVMODE structure. The format of the output array depends on the 
capability being queried. If output is (the default), DeviceCapabilities 
returns the number of bytes required in the output array. Possible values for 
capability are as follows: 



Value 



Meaning 



DC_BINNAMES The function enumerates the paper bins on the given device. If a 

device driver supports this constant, the output array is a data structure 
that contains two members. The first member is an array identifying 
valid paper bins: 



short BinList[cBinMax] 
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The second member is an array of character strings specifying the bin 
names: 

char PaperNames[cBinMax] [cchBinName 

If a device driver does not support this value, the output array is empty and 
the return value is NULL. 

If output is NULL, the return value specifies the number of bins supported. 

DC_BINS 

The function retrieves a list of constants that identify the available bins and 
copies the list to the output array. If this array is NULL, the function returns 
the number of supported bins. The following bin identifiers can be 
returned: 

DMBIN_AUTO 

DMBIN_CASSETTE 

DMBIN_ENVELOPE 

DMBIN_ENVMANUAL 

DMBIN_FIRST 

DMBIN_LARGECAPACITY 

DMBIN_LARGEFMT 

DMBIN_LAST 

DMBIN_LOWER 

DMBIN_MANUAL 

DMBIN_MIDDLE 

DMBIN_ONLYONE 

DMBIN_SMALLFMT 

DMBIN_TRACTOR 

DMBINJJPPER 

DC_DRIVER 

The function returns the driver version number. 

DCJDUPLEX 

The function returns the level of duplex support. The return value is 1 if the 
function supports duplex output; otherwise it is 0. 

DC_ENUMRESOLUTIONS 

The function copies a list of available printer resolutions to the output array. 
The resolutions are copied as pairs of LONG integers; the first value of the 
pair specifies the horizontal resolution and the second value specifies the 
vertical resolution. If output is 0, the function returns the number of 
supported resolutions. 
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DC_EXTRA 

The function returns the number of bytes required for the device-specific 
data that is appended to the DEVMODE structure. 

DC.FIELDS 

The function returns a value indicating which members of the DEVMODE 
structure are set by the device driver. This value can be one or more of the 
following constants: 

DM_ORIENTATION 

DM_PAPERSIZE 

DM_PAPERLENGTH 

DM_PAPERWIDTH 

DlVi_SCALE 

DM_COPIES 

DM_DEFAULTSOURCE 

DM_PRINTQUALITY 

DM_COLOR 

DM_DUPLEX 

DM_YRESOLUTION 

DM_TTOPTION 

DC_FILEDEPENDENCIES 

The function returns a list of files that must be loaded when the device 
driver is installed. If output is and this value is specified, the function 
returns the number of file names that must be loaded. If output is nonzero, 
the function returns the specified number of 64-character file names. 

DC_MAXEXTENT 

The function returns the maximum supported paper-size. These 
dimensions are returned in a POINT structure; the x member gives the 
maximum paper width and the y member gives the maximum paper 
length. 

DC_MINEXTENT 

The function returns the minimum supported paper-size. These dimensions 
are returned in a POINT structure; the x member gives the minimum paper 
width and the y member gives the minimum paper length. 

DC_PAPERS 

The function retrieves a list of supported paper sizes and copies it to the 
output array. The function returns the number of sizes identified in the 
array. If output is 0, the function returns the number of supported paper 
sizes. 



Chapter 1, Library reference 311 



i rriniuu class 



EndDoc 



EndPage 



DC_PAPERSIZE 

The function retrieves the supported paper sizes (specified in .1 millimeter 

units) and copies them to the output array. 

DC_SIZE 

The function returns the size of the DEVMODE structure required by the 
given device driver. 

DC_VERSlON 

The function returns the device driver version number. 

If DeviceCapabilities succeeds, the return value depends on the value of 
capability, as noted above. Otherwise, the return value is GDI_ERROR. 

See also: r.DeviceCapabilitiesEx, struct DEVMODE, TDCr.GetDeviceCaps 

inline int EndDoc () ; 

Ends the current print job on this printer. EndDoc should be called 
immediately after a successfully completed print job. TPrintDC::AbortDoc 
should be used to terminate a print job because of error or user 
intervention. 

If successful, EndDoc returns a positive or zero value; otherwise a negative 
value is returned. 

For pre-Win 3.1 applications, documents are ended by calling EscapeO with 
escape value ENDDOC. For Win 3.1 and later, this escape method is 
superseded by the r.EndDoc function. TPrintDC::EndDoc automatically 
selects the appropriate call. 

See also: ::EndDoc, TPrintDCr.StartDoc, TPrintDC::AbortDC, 
TPrintDCr.Escape, ABORTDOC 

inline int EndPage (); 

Tells this printer's device driver that the application has finished writing to 
a page. If successful, EndPage returns a positive or zero value; otherwise a 
negative value is returned. Possible failure values are listed below: 



Value 



Meaning 



SP_ERROR General error. 

SP_APPABORT Job terminated because the application's print-canceling function 

returned 0. 

SPJJSERABORT User terminated the job by using Windows Print Manager 

(PRINTMAN.EXE). 
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Value 



Meaning 



Escape 



SPJ3UT0FDISK 
SP OUTOFMEMORY 



Insufficient disk space for spooling. 
Insufficient memory for spooling. 



For pre- Win 3.1 applications, page ends are signaled by calling EscapeO 
with escape value NEWFRAME. For Win 3.1 and later, this escape method 
is superseded by the ::EndPage function. TPrintDC::EndPage automatically 
selects the appropriate call. 

See also: ::EndPage, TPrintDCr.StartPage, TPrintDC: -.Escape, NEWFRRAME 



inline int Escape (int escape, int count=0, const void* inData= 
outData=0) ; 



void* 



Allows applications to access the capabilities of a particular device that are 
not directly available through the GDI of this DC. The Escape call is 
specified by setting a mnemonic value in the escape argument. In Win32 the 
use of Escape with certain escape values has been replaced by specific 
functions. The names of these new functions are based on the 
corresponding escape mnemonic, as shown in the following table: 



Value 



Action 



ABORTDOC 
BANDINFO 

BEGIN_PATH 

CLIP_TO_PATH 

DEVICEDATA 

DRAFTMODE 



DRAWPATTERNRECT 
ENABLEDUPLEX 



Superseded by TPrintDC::AbortDoc() in Win32. 

Obsolete in Win32. Because all printer drivers for 
Windows version 3.1 and later set the text flag in every 
band, this escape is useful only for older printer drivers. 

No changes for Win32. This escape is specific to 
PostScript printers. 

No changes for Win32. This escape is specific to 
PostScript printers. 

Superseded in Win32. Applications should use the 
PASSTHROUGH escape to achieve the same 
functionality. 

Superseded in Win32. Applications can achieve the same 
functionality by setting the dmPrintQuality member of the 
DEVMODE structure to DMRES_DRAFT and passing this 
structure to the CreateDC function. 

No changes for Win32. 

Superseded in Win32. Applications can achieve the same 
functionality by setting the dmDuplex member of the 
DEVMODE structure and passing this structure to the 
CreateDC function. 
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Value 



Action 



ENABLEPAIRKERNING 

ENABLERELATIVEWIDTHS 

ENDDOC 

END_PATH 

ENUMPAPERBINS 

ENUMPAPERMETRICS 

EPSPRINTING 
EXT_DEVICE_CAPS 

EXTTEXTOUT 

FLUSHOUTPUT 

GETCOLORTABLE 

GETEXTENDEDTEXTMETRICS 

GETEXTENTTABLE 

GETFACENAME 

GETPAIRKERNTABLE 
GETPHYSPAGESIZE 

GETPRINTINGOFFSET 

GETSCALINGFACTOR 



No changes for Win32. 

No changes for Win32. 

Superseded by TPrintDC::EndDoc() in Win32. 

No changes for Win32. This escape is specific to 
PostScript printers. 

Superseded in Win32. Applications can use 
TPrintDC::DeviceCapabilities() to achieve the same 
functionality. 

Superseded in Win32. Applications can use 
TPrintDCr.DeviceCapabilitiesQ to achieve the same 
functionality. 

No changes for Win32. This escape is specific to 
PostScript printers. 

Superseded in Win32. Applications can use 
TDC::GetDeviceCaps() to achieve the same functionality. 
This escape is specific to PostScript printers. 

Superseded in Win32. Applications can use 
TDC::ExtTextOut() to achieve the same functionality. This 
escape is not supported by the version 3.1 PCL driver. 

Removed for Win32. 

Removed for Win32. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. 

Superseded in Win32. Applications can use 
::GetCharWidth to achieve the same functionality. This 
escape is not supported by the version 3.1 PCL or 
PostScript drivers. 

No changes for Win32. This escape is specific to 
PostScript printers. 

No changes for Win32. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. 
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Value 



Action 



GETSETPAPERBINS 



GETSETPAPERMETRICS 



GETSETPAPERORIENT 



GETSETSCREENPARAMS 
GETTECHNOLOGY 

GETTRACKKERNTABLE 
GETVECTORBRUSHSIZE 

GETVECTORPENSIZE 

MFCOMMENT 
NEWFRAME 



NEXTBAND 

PASSTHROUGH 

QUERYESCAPESUPPORT 

RESTORE_CTM 

SAVE CTM 



Superseded in Win32. Applications can achieve the same 
functionality by calling TPrintDC::DeviceCapabilities() to 
find the number of paper bins, calling ::ExtDeviceMode to 
find the current bin, and then setting the dmDefaultSource 
member of the DEVMODE structure and passing this 
structure to the CreateDC function. GETSETPAPERBINS 
changes the paper bin only for the current device context. 
A new device context will use the system-default paper bin 
until the bin is explicitly changed for that device context. 

Obsolete in Win32. Applications can use 
TPrintDC::DeviceCapabilities() and ::ExtDeviceMode() to 
achieve the same functionality. 

Obsolete in Win32. Applications can achieve the same 
functionality by setting the dmOrientation member of the 
DEVMODE structure and passing this structure to the 
CreateDC function. This escape is not supported by the 
Windows 3.1 PCL driver. 

No changes for Win32. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. This escape is not 
supported by the Windows 3.1 PCL driver. 

No changes for Win32. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. 

No changes for Win32. 

No changes for Win32. Applications should use 
::StartPage() and ::EndPage() instead of this escape. 
Support for this escape might change in future versions of 
Windows. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. 

No changes for Win32. 

No changes for Win32. 

No changes for Win32. This escape is specific to 
PostScript printers. 

No changes for Win32. This escape is specific to 
PostScript printers. 
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Value 



Action 



SELECTPAPERSOURCE 

SETABORTPROC 

SETALLJUSTVALUES 

SET_ARC_DIRECTION 
SET_BACKGROUND_COLOR 

SET_BOUNDS 

SETCOLORTABLE 

SETCOPYCOUNT 



SETKERNTRACK 
SETLINECAP 

SETLINEJOIN 

SETMITERLIMIT 

SET_POLY_MODE 

SET_SCREEN_ANGLE 

SET_SPREAD 

STARTDOC 

TRANSFORM CTM 



Obsolete in Win32. Applications can achieve the same 
functionality by using TPrintDC::DeviceCapabilities(). 

Superseded in Win32 by ::SetAbortProc(). See 
TPrintDC::SetAbortProc. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. This escape is not 
supported by the Windows 3.1 PCL driver. 

No changes for Win32. This escape is specific to 
PostScript printers. 

No changes for Win32. Applications should use 
::SetBkColor() instead of this escape. Support for this 
escape might change in future versions of Windows. 

No changes for Win32. This escape is specific to 
PostScript printers. 

No changes for Win32. Support for this escape might 
change in future versions of Windows. 

Superseded in Win32. An application should call 
TPrintDC::DeviceCapabilities(), specifying DC_COPIES 
for the nlndex parameter, to find the maximum number of 
copies the device can make. Then the application can set 
the number of copies by passing to the CreateDC function 
a pointer to the DEVMODE structure. 

No changes for Win32. 

No changes for Win32. This escape is specific to 
PostScript printers. 

No changes for Win32. This escape is specific to 
PostScript printers. 

No changes for Win32. This escape is specific to 
PostScript printers. 

No changes for Win32. This escape is specific to 
PostScript printers. 

No changes for Win32. 

No changes for Win32. 

Superseded in Win32. Applications should call ::StartDoc 
instead of this escape. 

No changes for Win32. This escape is specific to 
PostScript printers. 
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NextBand 



Escape calls are translated and sent to the printer device driver. The inData 
buffer lets you supply any data needed for the escape. You must set count 
to the size (in bytes) of the inData buffer. If no input data is required, inData 
and count should be set to the default value of 0. Similarly, you must supply 
an outData buffer for those Escape calls that retrieve data. If the escape does 
not supply output, set outData to the default value of 0. 

See also: -.-.Escape 

int NextBand (TRectfc rect); 

Tells this printer's device driver that the application has finished writing to 
a band. The device driver sends the completed band to the Print Manager 
and copies the coordinates of the next band in the rectangle specified by 

rect. 

If successful, NextBand returns a positive or zero value; otherwise a 
negative value is returned. Possible failure values are listed below: 



Value 



Meaning 



QueryAbort 




SP_ERR0R 
SP_APPABORT 

SP_USERABORT 

SP.OUTOFDISK 
SP_OUTOFMEMORY 



General error. 

Job terminated because the application's print-canceling function 
returned 0. 

User terminated the job by using Windows Print Manager 
(PRINTMAN.EXE). 

Insufficient disk space for spooling. 

Insufficient memory for spooling. 



See also: TprintDCr.Escape, NEXTBAND, TPrintDC: :BandInfo 

inline BOOL QueryAbort ( int rsvd=0); 

Tries to call the AbortProc callback function for this printer to determine if a 
print job should be aborted or not. QueryAbort returns the value returned 
by AbortProc or TRUE if no such callback function exists. TRUE indicates 
that printing should continue; FALSE indicates that the print job should be 
terminated. The rsvd argument is a reserved value that should be set to 0. 

See also: -.-.Query Abort, TPrintDC:: Set AbortProc, TPrintDC:: AbortDoc, 
-.-.AbortProc 

QueryEscSupport inline UINT QueryEscSupport(int escapeNum); 

Returns TRUE if the escape specified by escapeNum is implemented on this 
device; otherwise FALSE. 

See also: TPrintDC::Escape, QUERYESCSUPPORT 
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SetAbortProc 



SetCopyCount 



StartDoc 



StartPage 



inline int SetAbortProc (ABORTPROC proc); 

Establishes the user-defined proc as the printer-abort function for this 
printer. This function is called by TPrintDC: :AbortDoc to cancel a print job 
during spooling. 

Note that for pre- Win 3.1 applications, abort functions are set by calling 
EscapeO with escape value SETABORTPROC. For Win 3.1 and later, this 
escape method is superseded by the -.-.SetAbortProc function. 
TPrintDC::SetAbortProc automatically selects the appropriate call. 

SetAbortProc returns a positive (nonzero) value if successful; otherwise it 
returns a negative (nonzero) value. 

See also: -.-.SetAbortProc, TPrinterDCr.Escape, SETABORTPROC 

inline int SetCopyCount (int reqestCount, int& actualCount); 

Sets to requestCount the number of uncollated copies of each page that this 
printer should print. The actual number of copies to be printed is copied to 
actualCount. The actual count will be less than the requested count if the 
latter exceeds the maximum allowed for this device. SetCopyCount returns 1 
if successful; otherwise, it returns 0. 

See. also: TPrintDC: :DeviceCapabilities, TPrintDC: -.Escape, SETCOPYCOUNT 

inline int StartDoc (const char far* docName, const char far* output); 

Starts a print job for the named document on this printer DC. If successful, 
StartDoc returns a positive value, the job ID for the document. If the call 
fails, the value SP_ERROR is returned. Detailed error information can be 
obtained by calling GetLastError. 

This function replaces the earlier -.-.Escape call with value STARTDOC. 

See also: v.StartDoc, ::GetJob, ::SetJob, TPrintDCr.EndDoc, 
TPrintDC -.-.Escape 

int StartPage () ; 

Prepares this device to accept data. The system disables ::ResetDC() 
between calls to StartPage and EndPage, so that applications cannot change 
the device mode except at page boundaries. 

If successful, StartPage returns a positive value; otherwise, a negative or 
zero value is returned. 

See also: -.-.StartPage, TPrintDCr.EndPage 
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Protected data members 



DOCINFO Doclnfo; 

Holds the input and output filenames used by TPrintDC::StartDoc(). The 
DOCINFO structure is defined as follows: 



typedef struct { 

int cbSize; 

LPSTR IpszDocName; 

LPSTR IpszOutput; 
} DOCINFO; 



// size of the structure, bytes 

// document name <= 32 chars inc. final 

// output file name 



The IpszOutput field allows a print job to be redirected to a file. If this field 
is NULL, the output will go to the device for the specified DC. 

See also: TPrintDC ::StartDoc 



TPrintDialog class 



printdia.h 



TPrintDialog displays a modal print or a print setup dialog box. The print 
dialog box lets you specify the characteristics of a particular print job. The 
setup dialog box lets you configure the printer and specify additional print 
job characteristics. 

Public constructors 

Constructor TPrintDialog (TWindow* parent, TData& data, const char far* 

printTemplateName=0, const char far* setupTemplateName=0, 
const char far* title=0, TModule* module=0) ; 

Constructs a print or print setup dialog box with specified data, parent 
window, window caption, and module. 

Public member functions 



DoExecute 



GetDefauitPrinter 



int DoExecute I 



If no error occurs, DoExecute copies flags and print specifications into data. 
If an error occurs, DoExecute sets the error number of data to a 
CommDlgExtendedError code. 

BOOL GetDefauitPrinter () ; 
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Data 



pd 



Without displaying a dialog box, GetDefaultPrinter gets the device mode 
and name that are initialized for the system default printer. 

Protected data members 

TData& Data; 

Data is a reference to the TData object passed in the constructor. 

See also: TPrintDialog::TData 

PRINTDLG pd; 

Specifies the dialog box print job characteristics such as page range, 
number of copies, device context, and so on necessary to initialize the print 
or print setup dialog box. ObjectWindows passes this information to the 
Windows API PrintDlg function. 

See also: TPrintDialog::TData 



Protected member functions 



CmSetup 



DialogFunction 



inline void CmSetupO; 

Responds to the click of the setup button with an EV_COMMAND 
message. 

BOOL DialogFunction (UINT message, WPARAM, LPARAM) ; 

Returns TRUE if a message is handled. 

See also: TDialog::DialogFunction 



Response table entries 



The TPrintDialog response table has no entries. 



TPrintDialog: :TData struct 



printdia.h 



The TPrintDialog structure contains information necessary to initialize the 
dialog box with the user's printer selection. 
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Public data members 



Copies 



Error 



Constant 



int Copies; 

Copies indicates the number of copies to be printed. 

DWORD Error; 

Error contains one or more of the following CommDlgExtendedError codes: 

Meaning 



CDERRJDIALOGFAILURE 

CDERFLFINDRESFAILURE 

CDERRJ-OCKRESOURCEFAILURE 

CDERR_LOADRESFAILURE 

CDERR_MEMALLOCFAILURE 

CDERR_MEMLOCKFAILURE 

PDERR_CREATEICFAILURE 

PDERR DEFAULTDIFFERENT 



PDERR_DNDMMISMATCH 

PDERR_GETDEVMODEFAIL 

PDERRJNITFAILURE 

PDERR_LOADDRVFAILURE 

PDERR_NODEFAULTPRN 

PDERR_NODEVICES 

PDERR_PARSEFAILURE 

PDERR_PRINTERNOTFOUND 

PDERR RETDEFFAILURE 



Failed to create a dialog box. 

Failed to find a specified resource. 

Failed to lock a specified resource. 

Failed to load a specified resource. 

Unable to allocate memory for internal data structures. 

Unable to lock the memory associated with a handle. 

TPrintDialog failed to create an information context. 

The printer described by structure members doesn't match the default printer. This 

error message can occur if the user changes the printer specified in the control 

panel. 

The printer specified in DevMode and in DevNames is different. 

The printer device-driver failed to initialize the DevMode structure. 

The TPrintDialog structure could not be initialized. 

The specified printers device driver could not be loaded. 

A default printer could not be identified. 

No printer drivers exist. 

The string in the [devices] section of the WIN. INI file could not be parsed. 

The [devices] section of the WIN. INI file doesn't contain the specified printer. 

Either DevMode or DevNames contain zero. 



Flags 



Constant 



DWORD Flags; 

Flags can be one or more of the following Windows API constants: 

Meaning 



PD_ALLPAGES 

PD_COLLATE 

PD_DISABLEPRINTTOFILE 

PD_HIDEPRINTTOFILE 

PD_NOPAGENUMS 

PD_NOSELECTION 

PD_NOWARNING 

PD_PAGENUMS 

PD_PRINTSETUP 

PD_PRINTTOFILE 

PD RETURNDC 



Indicates that the All radio button was selected when the user closed the dialog box. 

Causes the Collate checkbox to be checked when the dialog box is created. 

Disables the Print to File check box. 

Hides and disables the Print to File check box. 

Disables the Pages radio button and the associated edit control. 

Disables the Selection radio button. 

Prevents the warning message from being displayed when there is no default printer. 

Selects the Pages radio button when the dialog box is created. 

Displays the Print Setup dialog box rather than the Print dialog box. 

Checks the Print to File check box when the dialog box is created. 

Returns a device context matching the selections that the user made in the dialog box. 
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Constant 



Meaning 



PD_RETURNDEFAULT 

PD_RETURNIC 

PD.SELECTION 
PD_SHOWHELP 
PD USEDEVMODECOPIES 



Returns DevNames structures that are initialized for the default printer without displaying a 

dialog box. 

Returns an information context matching the selections that the user made in the dialog 

box. 

Selects the Selection radio button when the dialog box is created. 

Shows the Help button in the dialog box. 

If a printer driver supports multiple copies, setting this flag causes the requested number of 

copies to be stored in the dmCopies member of the DevMode structure and 1 in Copies. If a 

printer driver does not support multiple copies, setting this flag disables the Copies edit 

control. If this flag is not set, the number 1 is stored in DevMode and the requested number 

of copies in Copies. 



From Page 
MaxPage 

MinPage 

ToPage 



int FrontPage; 

FrontPage indicates the beginning page to print. 

int MaxPage; 

MaxPage indicates the maximum value for the beginning and ending pages 
to print. 

int MinPage; 

MinPage indicates the minimum value for the beginning and ending pages 
to print. 

int ToPage; 

ToPage indicates the ending page to print. 

See also: ::PRINTDLG 



ClearDevMode 



ClearDevNames 



GetDeviceName 



Public member functions 



void ClearDevMode l 



Clears device mode information (information necessary to initialize the 
dialog controls). 

void ClearDevNames () ; 

Clears the device name information (information that contains three strings 
used to specify the driver name, the printer name, and the output port 
name). 

const char far* GetDeviceName ( ) . const; 

Gets the name of the output device. 
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GetDevMode inline const DEVMODE far* GetDevModeO const; 

Gets a pointer to a DEVMODE structure (a structure containing 
information necessary to initialize the dialog controls). 

GetDevNames inline const DEVNAMES far* GetDevNames ( ) const; 

Gets a pointer to a DEVNAMES structure (a structure containing three 
strings used to specify the driver name, the printer name, and the output 
port name). 

GetDriverName con st char far* GetDriverName ( ) const; 

Gets the name of the printer device driver. 
GetOutputName CO nst char far* GetOutputName ( ) const; 

Gets the name of the physical output medium. 
Lock void Lock(); 

Locks memory associated with the DEVMODE and DEVNAMES 
structures. 

SetDevMode vo id SetDevMode (const DEVMODE far* devMode) ; 

Sets the values for the DEVMODE structure. 

SetDevNames V oid SetDevNames (const char far* driver, const char far* device, 

const char far* output); 

Sets the values for the DEVNAMES structure. 

TransferDC TPrintDC* TransferDCO ; 

Creates and returns a TPrintDC with the current settings. 

Unlock vo id uniockO; 

Unlocks memory associated with the DEVMODE and DEVNAMES 
structures. 



TPrintPreviewDC class 



preview.h 



Derived from TPrintDC, TPrintPreviewDC maps printer device coordinates 
to logical screen coordinates. It sets the extent of the view window and 
determines the screen and printer font attributes. Many of 
TPrintPreviewDC'^ functions override TDC's virtual functions. 
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Public constructors and destructor 



Constructor 



Destructor 



TPrintPreview(TDC& screen, TPrintDC& printdc, const TRect& client, const 
TRect& clip) ; 

TPrintPreviewDC's constructor takes a screen DC as well as a printer DC. 
The screen DC is passed to the inherited constructor while the printer DC is 
copied to the member, PrnDC. 

-TPrintPreviewDC () ; 

Destroys a TPrintPreviewDC object. 



Public member functions 



GetDeviceCaps 



LPtoSDP 



OffsetViewportOrg 



ReOrg 



ReScale 



int GetDeviceCaps (int index) const; 

GetDeviceCaps returns capability information, such as font and pitch 
attributes, about the printer DC. The index argument specifies the type of 
information required. 

See also: TDC::GetDeviceCaps 

inline BOOL LPtoSDP (TPoint* points, int count = 1) const; 

inline BOOL LPtoSDP (TRect& rect) const; 

Converts each of the count points in the points array from logical points of 
the printer DC to screen points. Returns nonzero if the call is successful; 
otherwise, it returns 0. 

See also: TPrintPreviewDC: :SDPtoLP, TDCr.LPtoDP 

BOOL OffsetViewportOrg (const TPointk delta, TPoint far* oldOrg = 0); 

Modifies this DCs viewport origin relative to the current values. The delta 
x- and y-components are added to the previous origin and the resulting 
point becomes the new viewport origin. The previous origin is saved in 
oldOrg. Returns nonzero if the call is successful; otherwise, returns 0. 

See also: TPrintPreviewDCr.SetViewportOrg, TDCr.OffsetViewportOrg 

virtual void ReOrgO; 

Gets the x- and y- extents of the viewport, equalizes the logical and screen 
points, and resets the x- and y- extents of the viewport. 

virtual void ReScaleO; 

Maps the points of the printer DC to the screen DC. Sets the screen window 
extent equal to the maximum logical pointer of the printer DC. 
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RestoreFont void RestoreFont ( ) ; 

Restores the original GDI font object to this DC. 

See also: TPrintPreviewDC: :SelectObject, TDC::OrgFont 

ScaleViewportExt BOOL ScaleViewportExt(int xNum, int xDenom, int yNum, int yDenom, 

TSize far* oldExtent = 0); 



ScaleWindowExt 



SDPtoLP 



SeiectObject 



SelectStockObject 



Modifies this DCs viewport extents relative to the current values. The new 
extents are derived as follows: 

xNewVE = (xOldVE * xNum)/ xDenom 
yNewVE = (yOldVE * yNum)/ yDenom 

The previous extents are saved in oldExtent. Returns nonzero if the call is 
successful; otherwise returns 0. 

See also: TDC::ScaleViewportExt, TPrintPreviewDCr.SetViewportExt 

BOOL ScaleWindowExt (int xNum, int xDenom, int yNum, int yDenom, 
TSize far* oldExtent = 0); 

Modifies this DCs window extents relative to the current values. The new 
extents are derived as follows: 

xNewWE = (xOldWE * xNum)/ xDenom 
yNewWE = (yOldWE * yNum)/ yDenom 

The previous extents are saved in oldExtent. Returns nonzero if the call is 
successful; otherwise returns 0. 

See also: TDCr.SetWindowExt, TPrintPreviewDCr.ScaleWindowExt 

inline BOOL SDPtoLP (TPoint* points, int count = 1) const; 

inline BOOL SDPtoLP (TRect& rect) const; 

Converts each of the count points in the points array from screen device 
points to logical points of the printer DC. SDPtoLP returns nonzero if the 
call is successful; otherwise, it returns 0. 

See also: TPrintPreviewDCr.LPtoSDP, TDC::DPtoLP 

void SeiectObject (const TFontk newFont) ; 
Selects the given font object into this DC. 
See also: TPrintPreviewDCr.SelectStockObject, TDC:: SeiectObject 

void SelectStockObject (int index); 
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SetBkColor 



SetMapMode 



SetTextColor 



SetViewportExt 



SetViewportOrg 



SetWindowExt 



Retrieves a handle to a predefined stock font. 
See also: TDC::SelectStockObject 

TColor SetBkColor (TColor color); 

Sets the current background color of this DC to the given color value or the 
nearest available. Returns 0x80000000 if the call fails. 

See also: TDC:: SetBkColor 

int SetMapMode (int mode); 

Sets the current window mapping mode of this DC to mode. Returns the 
previous mapping mode value. The mapping mode defines how logical 
coordinates are mapped to device coordinates. It also controls the 
orientation of the device's x- and y-axes. 

See also: TDCr.GetMapMode, TDCr.SetMapMode 

TColor SetTextColor (TColor color); 

Sets the current text color of this DC to the given color value. The text color 
determines the color displayed by TDCr.TextOut and TDC::ExtTextOut. 

See also: TDCr.GetTextColor, TDCr.SetTextColor 

B00L SetViewportExt (const TSize& extent, TSize far* oldExtent = 0); 

Sets the screen's viewport x- and y-extents to the given extent values. The 
previous extents are saved in oldExtent. Returns nonzero if the call is 
successful; otherwise, returns 0. The extent value determines the amount of 
stretching or compression needed in the logical coordinate system to fit the 
device coordinate system, extent also determines the relative orientation of 
the two coordinate systems. 

See also: TDCr.GetViewportExt, TDCr.SetViewportExt 

BOOL SetViewportOrg ( const TPoint& origin, TPoint far* oldOrg=0); 

Sets the printer DCs viewport origin to the given origin value, and saves 
the previous origin in oldOrg. Returns nonzero if the call is successful; 
otherwise returns 0. 

See also: TPrintPreviewDC: :Off SetViewportOrg, TDCr.GetViewportOrg, 
TDC::SetViewportOrg 

BOOL SetWindowgExt (const TSize& extent, TSize far* oldExtent=0) ; 

Sets the DCs window x- and y-extents to the given extent values. The 
previous extents are saved in oldExtent. Returns nonzero if the call is 
successful; otherwise, returns 0. The extent value determines the amount of 
stretching or compression needed in the logical coordinate system to fit the 
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SyncFont 



device coordinate system, extent also determines the relative orientation of 
the two coordinate systems. 

See also: TDC::GetWindowExt, TDC::SetWindowExt, 
TPrintPreviewDC::ScaleWindowExt 

virtual void SyncFont ( ) ; 

Sets the screen font equal to the current printer font. 



Protected data members 



CurrentPreviewFont TFont* CurrentPreviewFont; 
The current view font. 
TPrintDCk PrnDC; 

Holds a reference to the printer DC. 
HFONT PrnFont; 
The current printer font. 



PrnDC 



PrnFont 



Protected member functions 



GetAttributeHDC H DC GetAttributeHDCO const; 

Returns the attributes of the printer DC (PrnDC). 
See also: TDCr.GetAttributeHDC 

TPrinter class 



printer.h 



TPrinter represents the physical printer device. To print or configure a 
printer, initialize an instance of TPrinter. 



Public constructors and destructor 



Constructor 



Destructor 



TPrinter! 



Constructs an instance of TPrinter associated with the default printer. To 
change the printer, call SetDevice after the object has been initialized or call 
Setup to let the user select the new device through a dialog box. 

virtual -TPrinter (); 
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Frees the resources allocated to TPrinter. 



Public member functions 



ClearDevice virtual void ClearDeviceO; 

Called by SetPrinter and the destructor, ClearDevice disassociates the device 
with the current printer. ClearDevice changes the current status of the 
printer to PF_UNASSOCIATED, which causes the object to ignore all calls 
to Print until the object is reassociated with a printer. 

Print virtual BOOL Print (TWindow* parent, TPrintout& printout, BOOL prompt); 

Print renders the given printout object on the associated printer device and 
displays an Abort dialog box while printing. It displays any errors 
encountered during printing. 

See also: TPrinterr.Error 

RepoitError virtual void ReportError(TWindow* parent, TPrintoutk printout); 

Print calls ReportError if it encounters an error. By default, it brings up the 
system message box with an error string created from the default string 
table. This function can be overridden to show a custom error dialog box. 

Setup virtual void Setup (TWindow* parent); 

Call this function when you want the user to select and /or configure the 
currently associated printer. Setup calls to return the printer setup dialog 
box that is shown to the user. 



Data 



Error 



Protected data members 

TPrintDialog: :TData* Data; 

Data is a reference to the TPrintDialog data structure that contains 
information about the user's print selection. 

See also: TPrintDialog: :TData struct 

int Error; 

Error is the error code returned by GDI during printing. This value is 
initialized during a call to Print. 
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Protected member functions 



CreateAbortWindOW virtual TWindow* CreateAbortWindow(TWindow* parent, TPrintoutk printout); 

Creates a printer abort dialog message box. 
ExecPrintDialog virtual BOOL ExecPrintDialog (TWindow* parent); 

Executes a TPrintDialog. 

GetDefaultPHnter virtual void GetDefaultPrinterO; 

Updates the printer structure with information about the user's default 
printer. 

SetPrinter inline void SetPrinter (const char* driver, const char* device, 

const char* output); 

SetPrinter changes the printer device association. Setup calls SetPrinter to 
change the association interactively. The valid parameters to this method 
can be found in the [devices] section of the WIN.INI file. 

Entries in the [devices] section have the following format: 

<device name>=<driver>,. <port> {, <port>} 

TPrinterAbortDIg class printer.h 

TPrinter AbortDlg is the object type of the default printer-abort dialog box. 
This dialog box is initialized to display the title of the current printout, as 
well as the device and port currently used for printing. 

TPrinterAbortDIg expects to have three static text controls, with control IDs 
of 101 for the title, 102 for the device, and 103 for the port. These controls 
must have "%s" somewhere in the text strings so that they can be replaced 
by the title, device, and port. The dialog-box controls can be in any position 
and tab order. 

Public constructors 

Constructor TPrinterAbortDIg (TWindow* parent, TResId resld, const char far* title, 

const char far* device, const char far* port); 

Constructs an Abort dialog box that contains a Cancel button and displays 
the given title, device, and port. 
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EvCommand 



SetupWindow 



Public member functions 



virtual LRESULT EvCommand (UINT id, HWND hWndCtl, UINT notifyCode) ; 
Handles the Cancel button on the Printer-abort dialog box. 

virtual void SetupWindow () ; 

Associates objects with the dialog resource template so that the title, device, 
and port can be determined for printing. See the description of 
TPrintoutFlags for information about printing flags and printer status 
information. 



See also: TPrintoutFlags enum 



TPrintout class 



printer.h 



TPrintout represents the physical printed document that is to sent to a 
printer to be printed. TPrintout does the rendering of the document onto 
the printer. Because this object type is abstract, it cannot be used to print 
anything by itself. For every document, or document type, a class derived 
from TPrintout must be created and its PrintPage function must be 
overridden. 



Public constructors and destructor 

Constructor TPrintout (const char far* title); 

Constructs an instance of TPrintOut with the given title. 
Destructor virtual -TPrintout () ; 

Destroys the resources allocated by the constructor. 



Public member functions 



BeginUOCUment virtual void BeginDocument(int startPage, int endPage, int flags); 

The printer object's Print function calls BeginDocument once before printing 
each copy of a document. The flags field indicates if the current print band 
accepts graphics, text, or both. 

The default BeginDocument does nothing. Derived objects can override 
BeginDocument to perform any initialization needed at the beginning of 
each copy of the document. 
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See also: TPrintoutFlags enum 

BeginPrinting virtual void BeginPrintingO ; 

The printer object's Print function calls BeginPrinting once at the beginning 
of a print job, regardless of how many copies of the document are to be 
printed. Derived objects can override BeginPrinting to perform any 
initialization needed before printing. 

EndDocument virtual void EndDocument ( ) ; 

The printer object's Print function calls EndDocument after each copy of the 
document finishes printing. Derived objects can override EndDocument to 
perform any needed actions at the end of each document. 

EndPHnting virtual void EndPrintingO; 

The printer object's Print function calls EndPrinting after all copies of the 
document finish printing. Derived objects can override EndPrinting to 
perform any needed actions at the end of each document. 

GetDialoglnfO virtual void GetDialoglnfo (int& minPage, int& maxPage, int& selFromPage, 

int& selToPage) ; 

GetDialoglnfo retrieves information needed to allow the printing of selected 
pages of the document and returns TRUE if page selection is possible. Use 
of page ranges is optional, but if the page count is easy to determine, 
GetDialoglnfo sets the number of pages in the document. Otherwise, set the 
number of pages to 0; printing will continue until HasPage returns FALSE. 

HasPage virtual BOOL HasPage(int pageNumber) ; 

HasPage is called after every page is printed. By default, it returns FALSE, 
indicating that only one page is to be printed. If the document contains 
more than one page, this function must be overridden to return TRUE 
while there are more pages to print. 

PnntPage virtual void PrintPage(int page, TRect& rect, unsigned flags); 

PrintPage is called for every page (or band, if Banding is TRUE) and must be 
overridden to print the contents of the given page. The rect and flags 
parameters are used during banding to indicate the extent and type of band 
currently requested from the driver (and should be ignored if Banding is 
FALSE), page is the number of the current page. 

SetPrintParams virtual void SetPrintParams (TPrintDC* dc, TSize pageSize); 

SetPrintParams sets DC to dc and PageSize to pageSize. The printer object's 
Print function calls SetPrintParams to obtain the information it needs to 
determine pagination and page count. Derived objects that override 
SetPrintParams must call the inherited function. 
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See also: TPreviewPage::Paint 



Protected data members 



Banding 



DC 



ForceAIIBands 



PageSize 



Title 



BOOL Banding; 

If Banding is TRUE, the printout is banded and the PrintPage function is 
called once for every band. Otherwise, PrintPage is called only once for 
every page. Banding a printout is more memory- and time-efficient than 
not banding. By default, Banding is set to FALSE. 

TPrintDC* DC- 
DC is the handle to the device context to use for printing. 

BOOL ForceAIIBands; 

Many device drivers do not provide all printer bands if both text and 
graphics are not performed on the first band (which is typically a text-only 
band). Leaving ForceAIIBands TRUE forces the printer driver to provide all 
bands regardless of what calls are made in the PrintPage function. If 
PrintPage does nothing but display text, it is more efficient for ForceAIIBands 
to be FALSE. By default, it is TRUE. ForceAIIBands takes effect only if 
Banding is TRUE. 

TSize PageSize; 

PageSize is the size of the print area on the printout page. 

char far* Title; 

Title is the current title to use for the printout. By default, this title appears 
in the Abort dialog box and as the name of the job in the Print Manager. 



TPrintoutFlags enum 



printer.h 



ObjectWindows defines the following banding constants used to set flags 
for printout objects. 



Constant 



Meaning 



pfBoth 
pf Graphics 
pfText 



Current band accepts both text and graphics. 
Current band accepts only graphics. 
Current band accepts only text. 



See also: TPrinter, TPrintOut 
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TProclnstance class 



pointh 



Designed for Winl6 applications, TProclnstance handles creating and 
freeing an instance thunk. For Win32 applications, TProclnstance is non- 
functional. The address returned from TProclnstance can be passed as a 
parameter to call-back functions, window subclassing functions, or 
Windows dialog box functions. See the Windows API online Help for more 
information about MakeProcInstance and FreeProcInstance. 

Public constructors and destructor 



Constructor 



Destructor 



TProclnstance (FARPROC p) ; 

Makes a TProclnstance, passing p as the address of the procedure. Under 
Winl6, calls : MakeProcInstance to make an instance thunk for p. Under 
Win32, the constructor just saves p. 

See also: ::MakeProcInstance 

-TProclnstance () 

Under WIN16, frees the instance thunk. 

See also: ::FreeProcInstance. 



Public member functions 



operator 
FARPROC 



operator FARPROC ( ) ; 

Under WIN16, returns the instance thunk. Under Win32, returns p from the 
constructor. 



TPXPictureValidator class 



validate.h 



TPXPictureValidator objects compare user input with a picture of a data 
format to determine the validity of entered data. The pictures are 
compatible with the pictures Borland's Paradox relational database uses to 
control data entry. For a complete description of picture specifiers, see the 
Picture member function. 



Public constructors 



Constructor 



TPXPictureValidator (const char far* pic, BOOL autoFill=FALSE) ; 
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Error 



IsValid 



IsValidlnput 



Picture 



Constructs a picture validator object by first calling the constructor 
inherited from TValidator and setting pic to point to it. Then sets the voFill 
bit in Options if AutoFill is TRUE and sets Options to voOnAppend. Throws a 
TXValidator exception if the picture is invalid. 

Public member functions 

void Error () ; 

Overrides TValidator's virtual function and displays a message box that 
indicates an error in the picture format and displays the string pointed to 
by Pic. 

See also: TValidator -.-.Error 

BOOL IsValid (const char far* str); 

IsValid overrides TValidator's virtual function and compares the string 
passed in str with the format picture specified in Pic. IsValid returns TRUE 
if Pic is NULL or if Picture returns Complete for str, indicating that str needs 
no further input to meet the specified format; otherwise, it returns FALSE. 

See also: TPXPictureValidator -.-.Picture 

BOOL IsValidlnput (char far* str, BOOL suppressFill); 

IsValidlnput overrides TValidator's virtual function and checks the string 
passed in str against the format picture specified in Pic. IsValid returns 
TRUE if Pic is NULL or Picture does not return Error for str; otherwise, it 
returns FALSE. The suppressFill parameter overrides the value in voFill for 
the duration of the call to IsValidlnput. 

If suppressFill is FALSE and voFill is set, the call to Picture returns a filled 
string based on str, so the image in the edit control automatically reflects 
the format specified in Pic. 

See also: TPXPictureValidator::Picture 

virtual TPicResult Picture(char far* input, BOOL autoFill=FALSE) ; 

Formats the string passed in input according to the format specified by the 
picture string pointed to by Pic. Picture returns prError if there is an error in 
the picture, string or if input contains data that cannot fit the specified 
picture. Returns prComplete if input can fully satisfy the specified picture. 
Returns prlncomplete if input contains data that incompletely fits the 
specified picture. 
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Table 1.28 

Picture format 

characters 



The following characters are used in creating format pictures: 



Type of character 


Character 


Description 


Special 


# 


Accept only a digit 




? 


Accept only a letter (casejnsensitive) 




& 


Accept only a letter, force to uppercase 




@ 
! 


Accept any character 

Accept any character, force to uppercase 


Match 


; 


Take next character literally 




* 


Repetition count 







Option 




{} 


Grouping operators 
Set of alternatives 




All others 


Taken literally 



See also: TPicResult enum 



Protected data member 



Pic 



CalcTerm 
CheckComplete 
Group 
Iteration 

Process 
Scan 



string Pic- 
Points to a string containing the picture that specifies the format for data in 
the associated edit control. The constructor sets Pic to a string that is passed 
as one of the parameters. 



Protected member functions 



UINT CalcTerm(UINT termCh, UINT i); 

Calculates the end of an input group without modifying it. 

TPicResult CheckComplete (UINT termCh, UINT& i, TPicResult rslt); 
Checks termCh and returns pr Ambiguous if the result is ambiguous. 

TPicResult Group (char far* input, UINT termCh, UINT& i, UINT& j); 
Processes a picture group. 

TPicResult Iteration (char far* input, UINT termCh, UINT& i, UINT& j); 

The input string {input) is repeated a specified number of times. termCh is 
the position of the last character in the string. i is the current index. 

TPicResult Process (char far* input, UINT termCh, UINT& i, UINT& j); 

Calls Scan to scan the input string for a specified character. 

TPicResult Scan(char far* input, UINT termCh, UINT& i, UINT& j); 
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Scans the input string for specified characters. 

SkipToComma B 00L SkipToComma(UINT termCh, UINT& i); 

Finds the next comma separator in the edit control. Returns FALSE if the 
edit control doesn't contain a comma. 

SyntaxCheck B 00L SyntaxCheck ( ) ; 

Checks the picture string for the specified character. If the picture string is 
NULL, SyntaxCheck returns FALSE. 

ToGroupEnd vo id ToGroupEnd(UINT termCh, UINT& i); 

Skips a character or a picture group specified in termCh. Characters 
specified include [, ], {, }, ;, *. 



TRadioButton class 



radiobut.h 



A TRadioButton is an interface object that represents a corresponding radio 
button element in Windows. Use TRadioButton to create a radio button 
control in a parent TWindow. A TRadioButton can also be used to facilitate 
communication between your application and the radio button controls of a 
TDialog. 

Radio buttons have two states: checked and unchecked. TRadioButton 
inherits its state management member functions from its base class, 
TCheckBox. Optionally, a radio button can be part of a group (TGroupBox) 
that visually and logically groups its controls. TRadioButton is a streamable 
class. 

Public constructors 



Constructor 



Constructor 



TRadioButton (TWindow* parent, int id, const char far* title, int x, int y, 
int w, int h, TGroupBox *group, TModule* module = 0); 

Constructs a radio button object with the supplied parent window (parent), 
control ID (id), associated text (title), position (x, y) relative to the origin of 
the parent window's client area, width (w), height (h), and associated group 
box (group). Invokes the TCheckBox constructor with similar parameters. 
Then sets the Attr. Style data member to WS_CHILD I WS_VISIBLE I 
BS AUTORADIOBUTTON. 



See also: TControlr.TControl 



TRadioButton (TWindow* 
TModule * 



parent, int resourceld, TGroupBox 
module = 0) ; 



* group, 
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Constructs a TRadioButton object to be associated with a radio button 
control of a TDialog. Invokes the TCheckBox constructor with identical 
parameters. The resourceld parameter must correspond to a radio button 
resource that you define. 

Protected member functions 



BNCIicked 



void BNClickedO; 

Responds to an incoming BN_CLICKED message. 



Response table entries 






Response table entry 


Member function 


EV MESSAGE (BM SETSTYLE, BMSetStyle) 
EV_WM_GETDIgCODE 


BMSetStyle 
EvGetDlgCode 



TRangeValidator class 



validate.h 



Constructor 



A TRangeValidator object determines whether the data typed by a user falls 
within a designated range of integers. TRangeValidator is a streamable class. 

Public constructors 

TRangeValidator (long min, long max); 

Constructs a range validator object by first calling the constructor inherited 
from TFilterValidator, passing a set of characters containing the digits '0'..'9' 
and the characters '+' and '-'. Sets Min to min and Max to max, establishing 
the range of acceptable long integer values. 

See also: TFilterValidatorr.TFilterValidator 

Public member functions 



Error 



IsValid 



void Error ( ) ; 

Error overrides TValidator's virtual function and displays a message box 
indicating that the entered value does not fall within the specified range. 

BOOL IsValidfconst char far* str) ; 
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Converts the string str into an integer number and returns TRUE if the 
result meets all three of these conditions: 

■ It is a valid integer number 

■ Its value is greater than or equal to min 
m Its value is less than or equal to max 

If any of those tests fails, IsValid returns FALSE. 

Transfer ujnt Transfer(char far* str, void* buffer, TTransferDirection direction); 

Incorporates the three types, tdSizeData, tdGetData, and tdSetData, that a 
range validator can handle for its associated edit control, str is the edit 
control's string value, and buffer is the data passed to the edit control. 
Depending on the value of direction, Transfer either sets str from the number 
in buffer or sets the number at buffer to the value of the string str. If direction 
is tdSetData, Transfer sets str from buffer. If direction is tdGetData, Transfer 
sets buffer from str. If direction is tdSizeData, Transfer neither sets nor reads 
data. 

Transfer always returns the size of the data transferred. 

See also: TWindow: -.Transfer 



Max 



Min 



Protected data members 



long Max; 

Max is the highest valid long integer value for the edit control. 

long Min; 

Min is the lowest valid long integer value for the edit control. 



TRect class point.h 

TRect is a support class derived from tagRect. Under Win32, tagRect 
is defined as 

typedef struct tagRECT { 

LONG left; 

LONG top; 

LONG right; 

LONG bottom; 
} RECT; 
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Under Winl6, tagRect is defined as 

typedef struct tagRECT { 

int left; 

int top; 

int right; 

int bottom; 
} RECT; 

TRect encapsulates the properties of rectangles with sides parallel to the x- 
and y-axes. In ObjectWindows, these rectangles define the boundaries of 
windows, boxes, and clipping regions. TRect inherits four data members 
from tagRect: left, top, right, and bottom. These represent the top left and 
bottom right (x, y) coordinates of the rectangle. Note that x increases from 
left to right, and y increases from top to bottom. 

TRect places no restrictions on the relative positions of top left and bottom 
right, so it is legal to have left > right and top > bottom. However, many 
manipulations — such as determining width and height, and forming 
unions and intersections — are simplified by normalizing the TRect objects 
involved. Normalizing a rectangle means interchanging the corner point 
coordinate values so that left < right and top < bottom. Normalization does 
not alter the physical properties of a rectangle. myRect.NormalizedO creates 
normalized copy of myRect without changing myRect, while 
myRect.NormalizeQ changes myRect to a normalized format. Both members 
return the normalized rectangle. 

TRect constructors are provided to create rectangles from either four ints, 
two TPoint objects, or one TPoint and one TSize object. In the latter case, the 
TPoint object specifies the top left point (also known as the rectangle's 
origin) and the TSize object supplies the width and height of the rectangle. 
Member functions perform a variety of rectangle tests and manipulations. 
Overloaded « and » operators are declared as friends of TRect, allowing 
chained insertion and extraction of TRect objects with streams. 

Public constructors 



Constructor 



Constructor 



Constructor 



TRect ( ) ; 

The default constructor. 

inline TRect (const RECT far& rect); 

Copies the given rect to this object. 

inline TRect (int _left, int _top, int _right, int _bottom) ; 

Creates a rectangle with the given values. 
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Constructor 



Constructor 



inline TRect(const TPoint& upLeft, const TPointk loRight); 
Creates a rectangle with the given top left and bottom right points. 
See also: TPoint 

inline TRect (const TPoint& origin, const TSizek extent); 

Creates a rectangle with its origin (top left) at origin, width at extent. ex, and 
height at extent.cy. 

See also: TPoint, TSize 



Public member functions 



Area 



BottomLeft 



BottomRight 



Contains 



Height 



inline long Area() const; 
Returns the area of this rectangle. 
See also: TRect::Size 

inline TPoint BottomLeft ()■ const; 

Returns the TPoint object representing the bottom left corner of this 
rectangle. 

See also: TRect: :TopLeft, TRect ::TopRight, TRect::BottomRight 

inline const TPointk BottomRight () const; 
inline TPointk BottomRight () ; 

Returns the TPoint object representing the bottom right corner of this 
rectangle. 

See also: TRect::TopRight, TRect "BottomLeft, TRect ::TopLeft 

inline BOOL Contains (const TPoint& point) const; 
inline BOOL Contains (const TRectk other) const; 

The first version returns TRUE if the given point lies within this rectangle; 
otherwise, it returns FALSE. If point is on the left vertical or on the top 
horizontal borders of the rectangle, Contains also returns TRUE, but if point 
is on the right vertical or bottom horizontal borders, Contains returns 
FALSE. 

The second version returns TRUE if the other rectangle lies on or within 
this rectangle; otherwise, it returns FALSE. 

See also: TRect::T ouches 

inline int Height () const; 
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InflatedBy 



IsEmpty 



IsNull 



Normalize 



Normalized 



Returns the height of this rectangle (bottom - top). 

See also: TRect:: Width 

inline TRect InflatedBy (int dx, int dy) const; 
inline TRect InflatedBy (const TSize& size) const; 

Returns a rectangle inflated by the given delta arguments. In the first 
version, the top left corner of the returned rectangle is (left - dx, top - dy), 
while its bottom right corner is (right + dx, bottom + dy). In the second 
version the new corners are (left - size.cx, top - size.cy) and (right + size.cx, 
bottom + size.cy). The calling rectangle object is unchanged. 

See also: TRectr.OffsetBy, TSize 

inline BOOL IsEmpty () const; 

Returns TRUE if left >= right or top >= bottom; otherwise, returns FALSE. 

See also: TRect ::SetEmpty, TRectr.IsNull 

inline BOOL isNullO const; 

Returns TRUE if left, right, top, and bottom are all 0; otherwise, returns 
FALSE. 

See also: TRect::IsEmpty, TRect::SetEmpty 

inline TRect& Normalized; 

Normalizes this rectangle by switching the left and right data member 
values if left > right, and switching the top and bottom data member values if 
top > bottom. Normalize returns the normalized rectangle. A valid but 
nonnormal rectangle might have left > right and/or top > bottom. In such 
cases, many manipulations (such as determining width and height) become 
unnecessarily complicated. Normalizing a rectangle means interchanging 
the corner point values so that left < right and top < bottom. The physical 
properties of a rectangle are unchanged by this process. 

See also: TRect: Normalized 

inline TRect Normalized (') const; 

Returns a normalized rectangle with the top left corner at (Mm(left, right), 
Mm(top, bottom)) and the bottom right corner at (Max(left, right), Max(top, 
bottom)). The calling rectangle object is unchanged. A valid but nonnormal 
rectangle might have left > right and /or top > bottom. In such cases, many 
manipulations (such as determining width and height) become 
unnecessarily complicated. Normalizing a rectangle means interchanging 
the corner point values so that left < right and top < bottom. The physical 
properties of a rectangle are unchanged by this process. 
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Offset 



OffsetBy 



operator* 



operator- 



operator& 



operatorl 



Note that many calculations assume a normalized rectangle. Some 
Windows API functions behave erratically if an inside-out Red is passed. 

See also: TRect: -.Normalize 

inline TRect& Offset (int dx, int dy) ; . 

Changes this rectangle so its corners are offset by the given delta values. 
The revised rectangle has a top left corner at (left + dx, top + dy) and a 
bottom right corner at (right + dx, bottom + dy). The revised rectangle is 
returned. 

See also: TRect: -.operator +, TRect: operator '+=, TRectr.OffsetBy 

inline TRect OffsetBy (int dx, int dy) const; 

Returns a rectangle with the corners offset by the given delta values. The 
returned rectangle has a top left corner at (left + dx, top + dy) and a bottom 
right corner at (right + dx, bottom + dy). 

See also: TRect::operator+ 

inline TRect operator+ (const TSize& size) const; 

Returns a rectangle offset positively by the delta values given size. The 
returned rectangle has a top left corner at (left + size.x, top + size.y) and a 
bottom right corner at (right + size.x, bottom + size.y). The calling rectangle 
object is unchanged. 

See also: TRectr.OffsetBy, TSize 

inline TRect operator- (const TSize& size) const; 

Returns a rectangle offset negatively by the delta values given size. The 
returned rectangle has a top left corner at (left - size.cx, top - size.cy) and a 
bottom right corner at (right - size.cx, bottom - size.cy). The calling rectangle 
object is unchanged. 

See also: TRectr.OffsetBy, TSize 

inline TRect operators (const TRect& other) const; 

Returns the intersection of this rectangle and the other rectangle. The calling 
rectangle object is unchanged. Returns a NULL rectangle if the two don't 
intersect. 

See also: TRect: -.operator I , TRect: -.operator &= 

inline TRect operatorl (const TRect& other) const; 

.Returns the union of this rectangle and the other rectangle. The calling 
rectangle object is unchanged. 
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operator— 



operator!= 



operator+= 



operators 



operator&= 



operators 



operator TPoint*() 



See also: TRect::operator&, TRect: operator I = 

inline BOOL operator== (const TRect& other) const; 

Returns TRUE if this rectangle has identical corner coordinates to the other 
rectangle; otherwise, returns FALSE. 

See also: TRect: -.operator != 

inline BOOL operator != (const TRect& other) const; 

Returns FALSE if this rectangle has identical corner coordinates to the other 
rectangle; otherwise, returns TRUE. 

See also: TRect::operator== 

inline TRect& operator+= (const TSize& delta); 

Changes this rectangle so its corners are offset by the given delta values, 
delta. x and delta. y. The revised rectangle has a top left corner at (left + 
delta. x, top + delta. y) and a bottom right corner at (right + delta. x, bottom + 
delta.y). The revised rectangle is returned. 

See also: TRect: -.operator ■+, TRect: :OffsetBy, TRectr.Offset 

inline TRect& operator— (const TSize& delta); 

Changes this rectangle so its corners are offset negatively by the given delta 
values, delta.x and delta.y. The revised rectangle has a top left corner at (left 
- delta.x, top - delta.y) and a bottom right corner at (right - delta.x, bottom - 
delta.y). The revised rectangle is returned. 

See also: TRect: -.operator-, TRect -.-.operator +=, TRect::OffsetBy, TRect::Offset 

inline TRect& operator&= (const TRect& other) const; 

Changes this rectangle to its intersection with the other rectangle. This 
rectangle object is returned. Returns a NULL rectangle if there is no 
intersection. 

See also: TRect::operator&, TRect -operator I = 

inline TRect& operator I = (const TRect& other) const; 

Changes this rectangle to its union with the other rectangle. This rectangle 
object is returned. 

See also: TRect: -.operator I , TRect: operator &= 

inline operator const TPoint*() const; 
inline operator TPoint*() 

Type conversion operators converting the pointer to this rectangle to type 
pointer to TPoint. 
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Set 



SetEmpty 



Size 



TopLeft 



TopRight 



Touches 



Width 



See also: class TPoint 

inline void Set(int _left, int _top, int _right, int _bottom) ; 

Repositions and resizes this rectangle to the given values. 

inline void SetEmpty ( ) ; 

Empties this rectangle by setting left, top, right, and bottom to 0. 

inline TSize Size() const; 

Returns a TSize object representing the width and height of this rectangle. 

See also: TSize 

inline const TPointk TopLeft () const; 
inline TPoint& TopLeft (); 

Returns the TPoint object representing the top left corner of this rectangle. 

See also: TRect::TopRight, TRect: -.BottomLeft, TRect: -.BottomRight 

inline TPoint TopRight () const; 

Returns the TPoint object representing the top right corner of this rectangle. 

See also: TRect::TopLeft, TRect y.Bottomheft, TRectr.BottomRight 

inline BOOL Touches (const TRect& other) const; 

Returns TRUE if the other rectangle shares any interior points with this 
rectangle; otherwise, returns FALSE. 

See also: TRectr.Contains 

inline int Width () const; 

Returns the width of this rectangle {right - left). 

See also: TRectr.Height 



Friend functions 



operator» 



operator« 



friend inline ipstreamk operator»(ipstream& is, TRect& r) const; 

Extracts a TRect object from is, the given input stream, and copies it to r. 
Returns a reference to the resulting stream, allowing the usual chaining of 
» operations. 

See also: TRect friend operator«, ipstream 

friend inline opstream& operator«(opstream& os, const TRect& r) const; 
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operator« 



Inserts the given TRect object, r, into the opstream, os. Returns a reference to 
the resulting stream, allowing the usual chaining of « operations. 

See also: TRect friend operator», opstream 

friend inline ostreamk operator«(ostream& os, const TRectk r) const; 

Formats and inserts the given TRect object, r, into the ostream, os. The 
format is (r.left, r.topXr.right, r.bottom). Returns a reference to the resulting 
stream and allows the usual chaining of « operations. 

See also: TRect friend operator», ostream 



TRegion class 



gdiobjec.h 



TRegion, derived from TGdiobject, represents GDI abstract shapes or 
regions. TRegion can construct region objects with various shapes. Several 
operators are provided for combining and comparing regions. 

Public data members 

enumTEIIipse enum TEllipse{Ellipse}; 

Defines the class-specific constant, Ellipse, used to distinguish the ellipse 
constructor from the rectangle copy constructor. 

See also: TRegion: :TRegion( const TRect& red), TRegion::TRegion(const 
TRect& E, TEllipse) 

Public constructors 

Constructor TRegionO; 

The default constructor creates an empty TRegion object. Handle is set to 
and ShouldDelete is set to TRUE. 

See also: TGdiObject::Handle, TGdiObjectr.ShouldDelete, ::CreateRectRgn 

Constructor TRegion (HRGN handle, TAutoDelete autoDelete = NoAutoDelete) ; 

Creates a TRegion object and sets the Handle data member to the given 
borrowed handle. The ShouldDelete data member defaults to FALSE, 
ensuring that the borrowed handle is not deleted when the C++ object is 
destroyed. HRGN is the Windows data type representing the handle to an 
abstract shape. 



Chapter 1, Library reference 



345 



TRegion class 



Constructor 



Constructor 



Constructor 



Constructor 



Constructor 



Constructor 



TRegion (const TRegionk region); 

This public copy constructor creates a copy of the given TRegion object, as 
in: 

TRegion myRegion = yourRegion; 

See also: ::CreateRectRgn, v.CombineRgn 

TRegion (const TRect& rect); 

Creates a region object from the given TRectangle object, as in: 

TRegion myRegion (recti ) ; 

TRegion* pRegion; 

pRegion = new TRegion (rect2 ) ; 

See also: ::CreateRectRgnIndirect, TRect 

TRegion (const TRect& E, TEllipse); 

Creates the elliptical TRegion object that inscribes the given rectangle E. The 
TEllipse argument distinguishes this constructor from the TRegion(const 
TRect& rect) constructor. 

See also: r.CreateEllipticRgnlndirect, TRect 

TRegion(const TRect& rect, const TSize& corner); 
Creates a TRegion object from the given rect and corner. 

TRegion(const TPoint* points, int count, int fillMode); 

Creates a filled TRegion object from the polygons given by points and 
fillMode. 

See also: ::CreatePolygonRgn, TPoint 

TRegion (const TPoint* points, const int* polyCounts, int count, 
int fillMode); 

Creates a filled TRegion object from the polygons given by points and 
fillMode. 

See also: ::CreatePolyPolygonRgn, TPoint 

Public member functions 



Contains 



inline BOOL Contains (const TPoint& point) const; 
Returns TRUE if this region contains the given point. 
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GetRgnBox 



See also: ::PtInRegion, TPoint 

inline int GetRgnBox (TRect& box) const; 
inline TRect GetRgnBox () const; 

Finds the bounding rectangle (the minimum rectangle containing this 
region). In the first version, the resulting rectangle is placed in box and the 
returned values are as follows: 



Value 



Meaning 



operator== 



operator != 



operator= 



operator += 



operator -= 



COMPLEXREGION 

NULLREGION 

SIMPLEREGION 



Region has overlapping borders. 

Region is empty. 

Region has no overlapping borders. 



In the second version, the resulting rectangle is returned. 
See also: r.GetRgnBox, TRect 

inline BOOL operator== (const TRegionk other) const; 

Returns TRUE if this region is equal to the other region. 

See also: r.EqualRgn, TRegionr.operatorl- 

inline BOOL operator != (const TRegion& other) const; 

Returns TRUE if this region is not equal to the other region. 

See also: r.EqualRgn, TRegion::operator== 

TRegion& operator = (const TRegionk source); 

Assigns the source region to this region. A reference to the result is 
returned, allowing chained assignments. 

See also: r.CombineRgn 

TRegionk operator+= (const TSizek delta); 

Adds the given delta to each point of this region to displace (translate) it by 
delta. x and delta. y. Returns a reference to the resulting region. 

See also: r.OffsetRgn, TSize, IRegionr.operator-- 

TRegionk operato,r-= (const TSize& delta); 
TRegionk operator-= (const TRegion& source); 

The first version subtracts the given delta from each point of this region to 
displace (translate) it by -delta.x and -delta.y. The second version uses the 
RGN_DIF argument in ::CombineRegion to create a "difference" region 
consisting of all parts of this region that are not parts of the source region. 
Both versions returns a reference to the resulting region. 



Chapter 1, Library reference 



347 



i Megion class 



operator &= 



operator 1= 



operator A = 



operator HRGN() 



SetRectRgn 



Touches 



See also: ::OffsetRgn, ::CombineRgn, TSize, TRegion::operator+=, RGN_DIF. 

TRegionk operator&= (const TRegion& source); 
TRegion& operator&= (const TRect& source); 

Creates the intersection of this region with the given source region or 
rectangle, and returns a reference to the result. 

See also: ::CombineRgn, TRect 

TRegion& operator I = (const TRegion& source); 
TRegionk operator I = (const TRect& source).; 

Creates the union of this region and the given source region or rectangle, 
and returns a reference to the result. 

See also: r.CombineRgn, TRect 

TRegion& operator A = (const TRegionk source);. 
TRegionk operator A = (const TRect& source); 

Creates the union of this region and the given source region or rectangle, 
but excludes any overlapping areas. Returns a reference to the resulting 
region object. 

See also: r.CombineRgn, TRect 

inline operator HRGN() const; 

Typecast operator. HRGN is the Windows data type representing the 
handle to a physical region. 

inline void SetRectRgn (const TRectk rect); 

Uses the Win API SetRectRgn function to creates a rectangle of the size 
given by rect. (Does not use the local memory manager.) 

See also: -.-.SetRectRgn, TRect 

inline BOOL Touches (const TRect& rect) const; 

Returns TRUE if this region touches the given rectangle. 

See also: r.RectlnRegion, TRect 
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TRelationship enum 



layoutco.h 



enum TRelationship; 

Used by the TLayoutConstraint struct, TRelationship specifies the relationship 
between the edges and sizes of one window and the edges and sizes of 
another window (which can be a parent or sibling). These relationships can 
be specified as either the same value as the sibling or parent window 
(ImAsIs), an absolute value (Im Absolute), a percent of one of the windows 
(ImPercentOf), a value that is either added above (ImAbove) or left (ImLeftOf) 
of one of the windows, or a value that is subtracted from below (ImBelow) 
or right (ImRightOf) of one of the windows. 

See also: TLayoutConstraint struct 



TReplaceDialog class 



findrepl.h 



Constructor 



TReplaceDialog creates a modeless dialog box that lets the user enter a 
selection of text to replace. 

Public constructors 

TReplaceDialog (TWindow* parent, TData&. data, TResID templateName=0, 
const char far* title=0, TModule* module=0); 

Constructs a TReplaceDialog object with a parent window, resource ID, and 
caption. Sets the attributes of the dialog box with the specified data. 

See also: TFindReplaceDialog::TData 



Protected member functions 



DoCreate 



HWND DoCreate ( ) ; 

Creates a modeless dialog box. 

See also: TDialogr.DoCreate 



Chapter 1, Library reference 



349 



TResId class 



TResId class 



point.h 



TResID is a simple support class that creates a resource ID object from 
either numerical or string resource identifier. This resource ID object can be 
passed to various ObjectWindows classes. 

Public constructors 

Constructor TResiDO; 

The default TResID constructor. Sets Id to 0. 

Constructor TResID(int resNum) ; 

Creates a TResID object with the given resNum. Uses the Windows macro 
MAKEINTRESOURCE to set Id to a compatible resource string for 
Windows resource-management functions. 

Constructor TResID (LPCSTR resString); 

Creates a TResID object with the given resString. Id is set to resString. 

Public member functions 



IsString 



inline BOOL IsString () const; 

Returns TRUE if this resource ID was created from a string; otherwise, 
returns FALSE. 



Operator LPSTR() inline operator LPSTRO ; 

Typecasting operator that converts Id to type LPSTR. 

Friend functions 



operator» 



operator« 



friend ipstream& operator»(ipstream& is, TResIDk id);' 

Extracts a TResID object from is (the given input stream), and copies it to id. 
Returns a reference to the resulting stream, allowing the usual chaining of 
» operations. 

See also: TResID friend operator«, ipstream 

friend opstream& operator«(opstream& os, const TResID& id); 
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operator« 



Inserts the given TResID object (id) into the opstream (os). Returns a 
reference to the resulting stream, allowing the usual chaining of « 
operations. 

See also: TResID friend operator», opstream 

friend ostream& operator«(ostream& os, const TResID& id); 

Formats and inserts the given TResID object (id) into the ostream (os). 
Returns a reference to the resulting stream, allowing the usual chaining of 
« operations. 

See also: TResID friend operator», ostream 



TResponseTableEntry class 



eventhan.h 



A template class, TResponseTableEntry lets you define a pattern for entries 
into a response table. Entries consist of a message, a notification code, a 
resource ID , a dispatcher type, and a pointer to a member function. See 
Chapter 2 for a discussion of the format for response table entries. 

See DECLARE_RESPONSE_TABLE and DEFINE_RESPONSE_TABLE for 
additional information about the macros in the response tables. 

Public data members 



Dispatcher 



Id 



Msg 



NotifyCode 



TAnyDispatcher Dispatcher; 

An abstract dispatcher type, Dispatcher points to one of the dispatcher 
functions. 

UINT Id; 

Contains the menu or accelerator resource ID (CM_xxxx) for the message 
response member function. 

UINT Msg; 

Contains the ID of the message sent. These can be command messages, 
child id messages, notify-based messages such as LBN_SELCHANGE, or 
Windows messages such as LBUTTONDOWN. 

UINT NotifyCode; 

Stores the control notification code (for example, IDJLISTBOX) for the 
response table entry. These can be button, combo box, edit control, or list 
box notification codes. 
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Pmf 



PMF Pmf; 

Pmf points to the actual handler or member function. 

typedef void (T::*PMF) (); 

Type for generic member function that responds to notification messages. T 
is the template for the response table. 



TRgbQuad class 



color.h 



TRgbQuad is a support class derived from the structure tagRGBQUAD, 
which is defined as follows: 

typedef struct tagRGBQUAD { 

BYTE rgbBlue; 

BYTE rgbGreen; 

BYTE rgbRed; 

BYTE rgbReserved; 
} RGBQUAD; 

where rgbBlue, rgbGreen, and rgbRed specify the relative blue, green, and 
red intensities of a color. rgbReserved is not used and must be set to 0. 

TRgbQuad is used in conjunction with the classes TPalette and TColor to 
simplify RGBQUAD-based color operations. Constructors are provided to 
create TRgbQuad objects from explicit RGB values, from TColor objects, or 
from other TRgbQuad objects. 

Public constructors 



Constructor 



Constructor 



Constructor 



TRgbQuad ( int r, int g, int b) ; 

Creates a TRgbQuad object with rgbRed, rgbGreen, and rgbBlue set to r, g, and 
b respectively. rgbReserved is set to 0. 

See also: tagRGBQUAD struct 

TRgbQuad( TColor c) ; 

Creates a TRgbQuad object with rgbRed, rgbGreen, and rgbBlue set to c.RedO, 
c.GreenO, and c.BlueO respectively. rgbReserved is set to 0. 

See also: tagRGBQUAD struct, TColor -.-.Red, TColor y.Green, TColorr.Blue 

TRgbQuad (const RGBQUAD far& q) ; 
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Creates a TRgbQuad object with the same values as the referenced 
RGBQUAD object. 

See also: struct tagRGBQUAD 



TRgbTriple class 



color.h 



Constructor 



Constructor 



Constructor 



TRgbTriple is a support class derived from the structure tagRgbTriple, which 
is defined as follows: 

typedef struct tagRGBTRIPLE { 

BYTE rgbBlue; 

BYTE rgbGreen; 

BYTE rgbRed; 
} RGBTRIPLE; 

where rgbBlue, rgbGreen, and rgbRed specify the relative blue, green, and 
red intensities for a color. 

TRgbTriple is used in conjunction with the classes TPalette and TColor to 
simplify bmci-color-based operations. Constructors are provided to create 
TRgbTriple objects from explicit RGB values, from TColor objects, or from 
other TRgbTriple objects. 

Public constructors 

TRgbTriple (int r, int g, int b) ; 

Creates a TRgbTriple object with rgbRed, rgbGreen, and rgbBlue set to r, g, 
and b respectively. 

See also: tagRGBTRIPLE struct 

TRgbTriple (TColor c) ; 

Creates a TRgbTriple object with rgbRed, rgbGreen, and rgbBlue set to c.Red(), 
c.GreenO, and c.BlueQ respectively. rgbReserved is set to 0. 

See also: tagRGBTRIPLE struct, TColor::Red, TColorr.Green, TColorr.Blue 

TRgbTriple (const RGBTRIPLE far& t); 

Creates a TRgbTriple object with the same values as the referenced 
RGBTRIPLE object. 

See also: tagRGBTRIPLE struct 
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TScreenDC class 



dc.h 



Derived from TWindowDC, TScreenDC is a DC class that provides direct 
access to the screen bitmap. TScreenDC gets a DC for Window handle 0, 
which is for the whole screen with no clipping. Window handle paints on 
top of other windows. 

Public constructors 

Constructor TScreenDC ( ) ; 

Default constructor for TScreenDC objects. 



TScrollBar 



scrollba.h 



TScrollBar objects represent standalone vertical and horizontal scroll bar 
controls. Most of TScrollBar's member functions manage the scroll bar's 
sliding box (thumb) position and range. 

One special feature of the type TScrollBar is the notify-based set of member 
functions that automatically adjust the scroll bar's thumb position in 
response to Windows scroll bar messages. 

fc^- Never place TScrollBar objects in windows that have either the 
WS_HSCROLL or WS_VSCROLL styles in their attributes. 

TScrollBar is a streamable class. 

Public data members 

LineMagnitude i nt LineMagnitude; 

LineMagnitude is the number of range units to scroll the scroll bar when the 
user requests a small movement by clicking on the scroll bar's arrows. 
TScrollBar's constructor sets LineMagnitude to 1 by default. (The scroll range 
is 0-100 by default.) 

See also: TScrollBar r.Setup Window 

PageMagnitUde i nt PageMagnitude; 

PageMagnitude is the number of range units to scroll the scroll bar when the 
user requests a large movement by clicking in the scroll bar's scrolling area. 
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TScrollBar's constructor sets PageMagnitude to 10 by default. (The scroll 
range is 0-100 by default.) 

Public constructors 

Constructor TScrollBar (TWindow* parent, int id, int x, int y, int w, int h, 

BOOL isHScrollBar, TModule* module = 0); 

Constructs and initializes a TScrollBar object with the given parent window 
(parent), a control ID (id), a position (x, y), and a size of (w, h). Invokes the 
TControl constructor with similar parameters. If isHScrollBar is TRUE, adds 
SBS_HORZ to the styles specified in Attr. Style. If not TRUE, adds 
SBSJVERT. If the supplied height for a horizontal scroll bar or the supplied 
width for a vertical scroll bar is 0, a standard value is used. LineMagnitude is 
initialized to 1 and PageMagnitude is set to 10. 

See also: TControlr.TControl 

Constructor . TScrollBar (TWindow* parent, int resourceld, TModule* module = 0); 

Constructs a TScrollBar object to be associated with a scroll bar control of a 
TDialog. Invokes the TControl constructor with identical parameters. 

The resourceld parameter must correspond to a scroll bar resource that you 
define. 

Public member functions 

DeltaPos virtual int DeltaPos( int delta) ; 

Calls SetPosition to change the scroll bar's thumb position by the value 
supplied in delta. A positive delta moves the thumb down or right. A 
negative delta value moves the thumb up or left. The new thumb position is 
returned. 

See also: TScrollBar:: SetPosition 

GetPositlon inline virtual int GetPositionO const; 

Returns the scroll bar's current thumb position. 

See also: TScrollBarr.SetPosition, TScrollBarData struct 

GetRange inline virtual void GetRange(int& min, int& max) const;. 

Returns the end values of the present range of scroll bar thumb positions in 
min and max. 

See also: TScrollBar::SetPosition, TScrollBar::SetRange, TScrollBarData struct 
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SBBottom 



SBLineDown 



SBLineUp 



SBPageDown 



SBPageUp 



SBThumbPosition 



SBThumbTrack 



virtual void SBBottom (); 

Calls SetPosition to move the thumb to the bottom or right of the scroll bar. 
SBJBOTTOM is called to respond to the thumb being dragged to the 
bottom or rightmost position of the scroll bar. 

See also: TScrollBar::SetPosition 

virtual void SBLineDown (.) ; 

Calls SetPosition to move the thumb down or right (by LineMagnitude units). 
SBLineDown is called to respond to a click on the bottom or right arrow of 
the scroll bar. 

See also: TScrollBar::SetPosition 

virtual void SBLineUpO; 

Calls SetPosition to move the thumb up or left (by LineMagnitude units). 
SBLineUp is called to respond to a click on the top or left arrow of the scroll 
bar. 

See also: TScrollBarr.SetPosition 

virtual void SBPageDown () ; 

Calls SetPosition to move the thumb down or right (by PageMagnitude 
units). SBPageDown is called to respond to a click in the bottom or right 
scrolling area of the scroll bar. 

See also: TScrollBar::SetPosition 

virtual void SBPageUpO; 

Calls SetPosition to move the thumb up or left (by PageMagnitude units). 
SBPageUp is called to respond to a click in the top or left scrolling area of 
the scroll bar. 

See also: TScrollBarr.SetPosition 

virtual void SBThumbPosition (UINT thumbPos) ;. 

Calls SetPosition to move the thumb. SBThumbPosition is called to respond 
when the thumb is set to a new position. 

See also: TScrollBar::SetPosition 

virtual void SBThumbTrack (UINT thumbPos); 

Calls SetPosition to move the thumb as it is being dragged to a new 
position. 

See also: TScrollBar::SetPosition 
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SBTop 



SetPosition 



SetRange 



Transfer 



virtual void SBTopO; 

Calls SetPosition to move the thumb to the top or right of the scroll bar. 
SBTop is called to respond to the thumb being dragged to the top or 
rightmost position on the scroll bar. 

See also: TScrollBarr.SetPosition 

virtual void SetPosition (int thumbPos); 

Moves the thumb to the position specified in ThumbPos. If ThumbPos is 
outside the present range of the scroll bar, the thumb is moved to the 
closest position within range. 

See also: TScrollBar::GetPosition 

inline virtual void SetRange (int min, int max); 
Sets the scroll bar to the range between min and max. 
See also: TScrollBarr.GetRange 

virtual UINT Transfer (void* buffer, TTransferDirection direction); 

Transfers scroll bar data to or from the transfer buffer pointed to by buffer, 
buffer is expected to point to a TScrollBarData structure. 

Data is transferred to or from the transfer buffer if tdGetData or tdSetData 
is supplied as the direction. 

Transfer always returns the size of the transfer data (the size of the 
TScrollBarData structure). To retrieve the size of this data without 
transferring data, pass tdSizeData as the direction. 

See also: TScrollBarData struct 



Protected member functions 



GetClassName char far* GetClassNameO; 

Returns the name of TScrollBar's Windows registration class, 
"SCROLLBAR." 

SetupWindoW void SetupWindow ( ) ; 

Sets the scroll bar's range to 0, 100. To redefine this range, call SetRange. 

See also: TScrollBar ::SetRange 
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TScrollBarData struct 



scrollba.h 



The TScrollBarData structure contains integer values that represent a range 
of thumb position on the scroll bar. TScrollBar's function GetRange calls 
TScrollBarData to obtain the highest and lowest thumb positions on the 
scroll bar. GetPosition calls TScrollBarData to obtain the current thumb 
position on the scroll bar. 

See also: TScrollBarr.Transfer 

Public data members 



HighValue 



LowValue 



Position 



int HighValue; 

Contains the highest value of the thumb position in the scroll bar's range. 

See also: TScrollBarr.GetRange 

int LowValue; 

Contains the lowest value of thumb position in the scroll bar's range. 

See also: TScrollBarr.GetRange 

int Position; 

Contains the scroll bar's thumb position. 

See also: TScrollBar::GetPosition 



TScroller class 



scroller.h 



TScroller supports an automatic window-scrolling mechanism (referred to 
as autoscrolling) that works in conjunction with horizontal or vertical 
window scroll bars (it also works if there are no scroll bars). When 
autoscrolling is activated, the window automatically scrolls when the 
mouse is dragged from inside the client area of the window to outside that 
area. If the AutoMode data member is TRUE, TScroller performs 
autoscrolling. 

To use TScroller, set the Scroller member of your TWindow descendant to a 
TScroller object instantiated in the constructor of your TWindow descendant. 
TScroller is a streamable class. 
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Public data members 



AutoMode 



AutoOrg 



HasHScrollBar, 
HasVSCrollBar 



TrackMode 
Window 
XLine, YLine 

XPage, YPage 

XPos,YPos 

XRange, YRange 
XUnit, YUnit 



BOOL AutoMode; 

Is TRUE if automatic scrolling is activated. 

BOOL AutoOrg; 

Is TRUE if scroller offsets original. 

BOOL HasHScrollBar, HasVSCrollBar; 

Is TRUE if scroller has horizontal or vertical scroll. 

BOOL TrackMode; 

Is TRUE if track scrolling is activated. 

TWindow* Window; 

Points to the window whose client area scroller is to be managed. 

int XLine, YLine; 

Specifies the number of logical device units per line to scroll the rectangle 
in the horizontal (X) and vertical (Y) directions. 

int XPage, YPage; 

Specifies the number of logical device units per page to scroll the rectangle 
in the horizontal (X) and vertical (Y) directions. 

long XPos, YPos; 

Specifies the current position of the rectangle in horizontal (XPos) and 
vertical (YPos) scroll units. 

long XRange, YRange; 

Specifies the number of horizontal and vertical scroll units. 

int XUnit, YUnit; 

Specifies the amount (in logical device units) to scroll the rectangle in the 
horizontal (X) and vertical (Y) directions. The rectangle is scrolled right if 
XUnit is positive and left if XUnit is negative. The rectangle is scrolled 
down if YUnit is positive and up if YUnit is negative. 

Public constructors and destructor 



Constructor TScroller(TWindow* window, int xUnit, int yUnit, long xRange, 

long y Range) ; 
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Destructor 



Constructs a TScroller object with window as the owner window, and xllnit, 
yllnit, xRange, and yRange as xllnit, yUnit, xRange and yRange, respectively. 
Initializes data members to default values. HasHScrollBar and HasVScrollBar 
are set according to the scroll bar attributes of the owner window. 

virtual -TScroller () ; 

Destructs a TScroller object. Sets owning window's Scroller number variable 
toO. 



Public member functions 



AutoScroll 



BeginView 



EndView 



HScroll 



IsAutoMode 



IsVisibleRect 



SetPageSize 



virtual void AutoScroll () ; 

Scrolls the owner window's display in response to the mouse being 
dragged from inside to outside the window. The direction and the amount 
by which the display is scrolled depend on the current position of the 
mouse. 

virtual void BeginView (TDC& dc, TRect& rect); 

If TScrollerr.AutoOrg is TRUE (default condition), BeginView automatically 
offsets the origin of the logical coordinates of the client area by XPos, YPos 
during a paint operation. If AutoOrg is FALSE (for example, when the 
scroller is larger than 32,767 units) you must set the offset manually. 

virtual void EndView ( ) ; 

Updates the position of the owner window's scroll bars to be coordinated 
with the position of the TScroller. 

virtual void HScroll (UINT scrollEvent, int thumbPos) ; 

Responds to the specified horizontal scrollEvent by calling ScrollBy or 
ScrollTo. The type of scroll event is identified by the corresponding 
Windows SB_ constants. thumbPos contains the current thumb position 
when the scroller is notified of SB_THUMBTRACK and 
SBJTHUMBPOSITION scroll events. 

virtual BOOL IsAutoMode () ; 

IsAutoModeis TRUE if automatic scrolling is activated. 

See also: TScrollerr.AutoMode 

inline BOOL IsVisibleRect (long x, lony y, int xExt, int yExt); 
Is TRUE if the rectangle (x, y, xExt, and yExt) is visible. 

virtual void SetPageSize () ; 
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SetRange 



SetSBarRange 



SetUnits 



ScrollBy 



ScrollTo 



SetWindow 



VScroll 



XScrollValue 



Sets the XPage and YPage data members to the width and height (in XUnits 
and YUnits) of the owner window's client area. 

See also: T Scroller r.XPage, TScroller::YPage, T Scroller ::XUnit, TScroller::YUnit 

virtual void SetRange (long xRange, long yRange); 

Sets the xRange and yRange of the TScroller to the parameters specified. 
Then calls SetSBarRange to synchronize the range of the owner window's 
scroll bars. 

See also: TScroller::SetSBarRange 

virtual void SetSBarRange () ; 

Sets the range of the owner window's scroll bars to match the range of the 
TScroller. 

virtual void SetUnits (int xUnit, int yUnit) ; 

Sets the XUnit and YUnit data members to TheXUnit and TheYUnit, 
respectively. Updates XPage and YPage by calling SetPageSize. 

See also: TScrollerwXPage, TScrollerr.YPage, TScrollerr.XUnit, T Scroller ::YUnit 

inline void ScrollBy(long dx, long dy) ; 

Scrolls to a position calculated using the passed delta values (dx and dy). A 
positive delta position moves the thumb position down or right. A negative 
delta position moves the thumb up or left. 

virtual void ScrollTo (long x, long y) ; 

Scrolls the rectangle to the position specified in x and y. 

inline void SetWindow (TWindow* win); 
Sets the owning window to win. 

virtual void VScroll (UINT scrollEvent, int thumbPos); 

Responds to the specified vertical scrollEvent by calling ScrollBy or ScrollTo. 
The type of scroll event is identified by the corresponding Windows SB_ 
constants. thumbPos contains the current thumb position when the scroller 
is notified of SB_THUMBTRACK and SB_THUMBPOSITION scroll events. 

See also: TScrollerr.ScrollTo 

inline int XScrollValue (long rangeUnit) ; 

XScrollValue converts a horizontal range value from the scroll bar to a 
horizontal scroll value. 

See also: TScroller::YScrollValue 
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XRangeValue inline int XRangeValue(int scrollUnit); 

XRangeValue converts a horizontal scroll value from the scroll bar to a 
horizontal range value. 

See also: TScroller::YRangeValue 

YScrollValue inline int YScrollValue (long rangeUnit) ; 

YScrollValue converts a vertical range value from the scroll bar to a vertical 
scroll value. 

See also: TScroller::XScrollValue 

YRangeValue inline int YRangeValue (int scrollUnit); 

YRangeValue converts a vertical scroll value from the scroll bar to a vertical 
range value. 

See also: TScrollerr.XRangeValue 



TSeparatorGadget class 



gadget.h 



TSeparatorGadget is a simple class you can use to create a separator between 
gadgets. To do so, you must specify the size of the separator in units of 
SM_CXBORDER (width of the window frame) and SM_CYBORDER 
(height of the window frame). The right and bottom boundaries of the 
separator are set after calling GetsystemMetrics. By default, the separator 
disables itself and turns off shrink-wrapping. Note that the default border 
style is none. 

See also: TGadgetr.TBorder Style enum 

Public member functions 



TSeparatorGadget TSeparatorGadget (int size = 



Used for both the width and the height of the separator, size is initialized at 
6 border units (the width or height of a thin window border). 
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TSize class 



pointh 



TSize is a support class derived from the structure tagSIZE. Under Win32, 
the latter is defined as 

typedef struct tagSize { 

LONG x; 

LONG y; 
} POINT; 

Under Winl6, tagSize is defined as 

typedef struct 

tagSIZE { 
int x; 
' ' int y; 

} POINT; 

typedef struct tagSIZE { 

LONG ex; . 

LONG cy; 
} SIZE;' 

TSize encapsulates the notion of a two-dimensional quantity that usually 
represents a displacement or the height and width of a rectangle. TSize 
inherits the two data members ex and cy from tagSIZE. As with TPoint, 
TSize objects can be created from a pair of ints, a point of type POINT, 
another value of type SIZE, or from the low and high words of a DWORD 
value. Member functions and operators are provided for comparing, 
assigning, and manipulating sizes. Overloaded « and » operators are 
declared as friends of TSize, allowing chained insertion and extraction of 
TSize objects with streams. 

Public constructors 

Constructor inline TSize () ; 

The default TSize constructor. 
Constructor inline TSize (int dx, int dy) ; 

Creates a TSize object with ex = dx and cy = dy. 
Constructor inline TSize ( const P0INT& point) ; 

Creates a TSize object with ex = point. x and cy = point. y. 

See also: Point 
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Constructor inline TSize (const SIZE& size); 

Creates a TSize object with ex = size.cx and cy = size.cy. 

See also: Size struct 
Constructor inline TSize (DWORD dw) ; 

Creates a TSize object with ex = LOWORD(dzv) and cy = HWORD(dw)). 

Public member functions 



Magnitude 



operator* 



operator- 



operator== 



operator!= 



inline int Magnitude () const; 

Returns the length of the diagonal of the rectangle represented by this 
object. The value returned is an int approximation to the square root of 

(cx 2 +cy 2 ). 

inline TSize operator+ (const TSize& size) const; 

Calculates an offset to this TSize object using the given size argument as the 
displacement. Returns the object (ex + size.cx, cy + size.cy). This TSize object 
is not changed. 

See also: TSize::operator- 

inline TSize operator- (const TSize& size) const; 
inline TSize operator- () const; 

The first version calculates a negative offset to this TSize object using the 
given size argument as the displacement. Returns the point (ex - size.cx, 
cy - size.cy). This object is not changed. 

The second version returns the TSize object (-ex, -cy). This object is not 
changed. 

See also: TSize::operator+ 

inline BOOL operator== (const TSize& other) const; 

Returns TRUE if this size object is equal to the other TSize object; otherwise 
returns FALSE. 

See also: TSize::operator!= 

inline BOOL operator! = (const TSize& other) const; 

Returns FALSE if this size object is equal to the other TSize object; otherwise 
returns TRUE. 

See also: TSizev.operator-- 
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operator+= 



operators 



operator» 



operator« 



operator« 



inline TSizek operator+= (const TSize& size) const; 

Offsets this TSize object by the given size argument. This TSize object is 
changed to (ex + size.cx, cy + size.cy). Returns a reference to this object. 

See also: TSizev.operator-- 

inline TSizek operator— (const TSizek size) const; 

Negatively offsets this TSize object by the given size argument. This object is 
changed to (ex - size.cx, cy - size.cy). Returns a reference to this object. 

See also: TSize::operator+= 

Friend functions 

friend inline ipstreamk operator»(ipstream& is, TSize& s) const; 

Extracts a TSize object from is, the given input stream, and copies it to s. 
Returns a reference to the resulting stream, allowing the usual chaining of 
» operations. 

See also: TSize friend operator«, ipstream 

friend inline opstreamk operator«(opstream& os, const TSize& s) const; 

Inserts the given TSize object (s) into the opstream (os). Returns a reference to 
the resulting stream, allowing the usual chaining of « operations. 

See also: TSize friend operator», opstream 

friend inline ostreamk operator«(ostream& os, const TSize& s) const; 

Formats and inserts the given TSize object (s) into the ostream (os). The 
format is "(ex x cy)". Returns a reference to the resulting stream, allowing 
the usual chaining of « operations. 

See also: TSize friend operator», ostream 



TSIider class 



slider.h 



An abstract base class derived from TScrollBar, TSIider defines the basic 
behavior of sliders (controls that are used for providing nonscrolling, 
position information). Like scroll bars, sliders have minimum and 
maximum positions as well as line and page magnitude. Sliders can be 
moved using either the mouse or the keyboard. If you use a mouse to move 
the slider, you can drag the thumb position, click on the slot on either side , 
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of the thumb position to move the thumb by a specified amount 
(PageMagnitude), or click on the ruler to position the thumb at a specific 
spot on the slider. The keyboard's Home and End keys move the thumb 
position to the minimum (Min) and maximum (Max) positions on the slider. 

TSHders can cause the thumb positions to automatically align with the 
nearest tick positions (this is called snapping). You can also specify the tick 
gaps (the space between the lines that separate the major divisions of the X- 
or Y-axis). 

The SLIDER.CPP ObjectWindows program on your distribution disk 
displays the following thermostat: 



rmmmmMm Mwmmmmmmmwm -i 
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Maximum position 
Thumb position 

Vertical slider 
— Minimum position 



Horizontal slider 
SLIDERAPP sets up the following constant values: 

const WORD ID_THERM0STAT =201; 
const WORD IDJffiATERTIME = 202; 
const WORD ID_OUTSIDETEMP = 203; 
const WORD ID_STATICTEMP = 205; 
const WORD IDJSTATICTIME = 206; 

and then sets the following ruler ranges and positions: 

TWindow: :SetupWindow( ) ; 

Thermostat->SetRange(40, 120);' 
Thermostat->SetRuler(5, FALSE); 
Thermostat->SetPosition(75) ; 

HeaterTime->SetRange(0, 20); 
HeaterTime->SetRuler(2, FALSE); 
HeaterTime->SetPosition(10) ; 
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OutsideTemp->SetRange(20, 90); 
OutsideTemp->SetRuler(5, FALSE); 
OutsideTemp->SetPosition(40) ; 

Thermometer->SetRange (40-10, 120+10) ; 
Thermometer- >SetValue (75) ; 
Thermometer- >SetLed (4, 90); 

before establishing the following values for static, gauge, and sliders: 

SetTimer(ID_TIMER, 1000); 

UpdateTemp ( ) ; 

UpdateHeaterTime ( ) ; 

UpdateOTemp ( ) ; 

StaticTemp = new TStatic (this, ID_STATICTEMP, "", 135, 40, 160, 17,0); 

Thermometer = new TGaugef this, ID_THERMOMETER, 70, 90, 240, 20, TRUE, 2); 

Thermostat = new THSlider( this, ID_THERMOSTAT, 70, 150, 240, 40); 

For the complete program, see the SLIDER.CPP ObjectWindows program 
on your distribution disk. 

See the two derived classes, THSHder and TVSlider, for specific details about 
horizontal and vertical sliders. 



Public constructors and destructor 



Constructor 



Destructor 



TSIider (TWindow* parent, int id, int X, int Y, int W, int H, 
TResId thumbResId, TModule* module = 0); 

Constructs a slider object setting Pos and ThumbRgn to 0, TicGap to Range 
divided by 10, SlotThick to 17, Snap to TRUE, and Sliding to FALSE. Sets 
Attr. W and Attr.H to the values in X and Y. ThumbResId is set to thumbResId. 

-TSIider (); 

Deconstructs a TSIider object and deletes ThumbRgn. 



Public member functions 



GetPosition 



GetRange 



inline int GetPosition () const; 

Returns the slider's current thumb position. Overloads TScrollBar's virtual 
function. 

See also: T Slider ::SetPosition 

inline void GetRange (int &min, int &max) const; 
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SetPosition 



SetRange 



SetRuler 



EvEraseBkgnd 



EvGetDlgCode 



EvKeyDown 



Returns the end values of the present range of slider thumb positions in 
min and max. Overloads TScrollBar's virtual function. 

See also: TSHder::SetRange 

void SetPosition (int thumbPos); 

Moves the thumb to the position specified in thumbPos. If thumbPos is 
outside the present range of the slider, the thumb is moved to the closest 
position within the specified range. Overloads TScrollBar's virtual function. 

See also: TSIider: :GetPosition 

void SetRange (int min, int max); 

Sets the slider to the range between min and max. Overloads TScrollBar's 
virtual function. 

See also: TSliderr.GetRange 

inline void SetRuler(int ticGap, BOOL snap = FALSE); 

Sets the slider's ruler. Each slider has a built-in ruler that is drawn with the 
slider. The ruler, which can be blank or have tick marks on it, can be created 
so that it forces the thumb to snap to the tick positions automatically. 

Protected member functions 

BOOL EvEraseBkgnd (HDC hDC) ; 

Responds to a WM_ERASEBKGND message and erases the background of 
the slider when the slider is changed. Calls the virtual functions PaintRuler, 
PaintSlot, and PaintThumb to paint the components of the slider. To avoid 
flickering, EvEraseBkgnd is called to erase the background as the painting 
occurs. 

See also: T Slider ::EvPaint 

UINT EvGetDlgCode ( ) ; 

Responds to a WM_GETDLGCODE message and controls the response to a 
DIRECTION key or TAB key input. Captures cursor-movement keys to 
move the thumb by returning a DLGC_W ANT ARROWS message, which 
indicates that direction keys are desired. 

void EvKeyDown (UINT key, UINT repeatCount, UINT flags); 

EvKeyDown translates the virtual key code into a movement and then 
moves the thumb, key indicates the virtual key code of the pressed or key, 
repeatCount holds the number of times the same key is pressed, and flags 
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contains one of the following messages, which translate to virtual key (VK) 
codes: 



Value 



Virtual key code 



SB_PAGEUP VK.PRIOR 

SB_PAGEDOWN VK_NEXT 

SB_BOTTOM VK_END 

SB_TOP VK_HOME 

SB_UNEUP VK_LEFT(same as SBJJNELEFT) 

SB_UNEUP VK_UP 

SB_UNEDOWN VK_RIGHT(same as SBJJNERIGHT) 

SB UNEDOWN VK DOWN 



EvKillFocus 



EvLButtonDblClk 



EvLButtonDown 



EvLButtonUp 



EvMouseMove 



void EvKillFocus (HWND hWndGetFocus) ; 

In response to a WM_KILLFOCUS message sent to a window that is losing 
the keyboard, EvKillFocus hides and then destroys the caret. 

void EvLButtonDblClk (UINT modKeys, TPoint& point); 

Responds to a WM_LBUTTONDBLCLK message (which indicates the user 
double-clicked the left mouse button), then throws away the messages so 
the base class doesn't receive them. 

void EvLButtonDown (UINT modKeys, TPointk point); 

Responds to a mouse press by positioning the thumb or beginning a mouse 
drag. If the mouse is pressed down while it is over the thumb, 
EvLButtonDown enters sliding state. If the mouse is in the slot, 
EvLButtonDown pages up or down. If the mouse is on the ruler, 
EvLButtonDown jumps to that position. EvLButtonDown generates a scroll 
code of SBJTHUMBPOSITION, SB_LINEUP, SB_LINEDOWN, 
SB_PAGEUP, SB_PAGEDOWN, SB_THUMBTRACK. 

See also: T Slider r.EvLButtonllp 

void EvLButtonUp (UINT modKeys, TPoint& point); 

If the mouse button is released, EvLButtonUp ends sliding, paging, or 
jumping to a position on the ruler. 

See also: T 'Slider: -.EvLButtonDown 

void EvMouseMove (UINT modKeys, TPoint& point); 

Moves the mouse to the indicated position. If the mouse is being dragged, 
EvMouseMove positions the thumb and sends the appropriate message to 
the parent window. 
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EvPaint 



EvSetFocus 



EvSize 



GetBkColor 



HitTest 



NotifyParent 



PaintRuler 



PaintSlot 



PaintThumb 



PointToPos 



void EvPaint () ; 

Paints the entire slider — ruler, slot, and thumb. Calls the virtual functions 
PaintRuler, PaintSlot, and PaintThumb to paint the components of the slider. 

See also: TSHder::EvEraseBkgnd 

void EvSetFocus (HWND hWndLos t Focus ) ; 

Creates a blinking caret to show the focus in the current window. 

See also: TSliderr.GetFocus 

void EvSize (UINT sizeType, TSize& size); 

Recalculates the size of the slider when the window size is changed. 

void GetBkColor (TDC& dc) ; 

Sends a WM_CTLCOLOR message to the parent and calls dc: -.GetBkColor to 
extract the background color for the slider. 

virtual int HitTest (TPoint& point) = 0; 

Gets information about where a given X, Y location falls on the slider. The 
return value is in scrollCodes. Each of the derived classes performs 
comparisons to return a scroll code. 

See also: TSliderr.NotifyParent 

virtual void NotifyParent (int scrollCode, int pos=0) = 0; 

Sends a WS_HSCROLL or WSJVSCROLL message to the parent window. 

See also: THSliderr.HitTest, TV Slider: -.HitTest 

virtual void PaintRuler (TDC& dc) = 0; 

Paints the ruler. It is assumed that the slot or thumb do not overlap the 
ruler. 

virtual void PaintSlot (TDC& dc) = 0; 

Paints the slot in which the thumb slides. 

virtual void PaintThumb (TDC& dc); 

Paint the thumb itself using a resource DIB translated to the current system 
button colors and which overlaps the slot. 

virtual int PointToPos (TPoint& point) = 0; 

Translates an X,Y point to a position in slider units. 

See also: TSlider::PosToPoint 
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PosToPoint 



SetupThumbRgn 



SetupWindow 



SlideThumb 



SnapPos 



Bkcolor 



CaretRect 



Max 



Min 



MouseOffset 



virtual TPoint PosToPoint (int pos) = 0; 
Translates a position in slider units to an X,Y point. 

See also: TSliderr.PointToPos 

virtual void SetupThumbRgn () ; 

Creates the region that defines the thumb shape for this slider class. 
Although the default region is a simple bounding rectangle, it can be any 
shape. While the slider thumb is being moved, this region is used for 
testing the mouse position and updating the thumb position. 

See also: ThumbRgn 

void SetupWindowO; 

Calls TScrollBar:: SetupWindow and SetupThumbRgn to set up the window. 

See also: TScrollBar: -.SetupWindow 

virtual void SlideThumb (TDC& dc, int thumbPosl); 

Slides the thumb to a given position and performs the necessary blitting 
and painting. 

int SnapPos (int pos); 

Constrains Pos so it is in the range from Min to Max and (if snapping is 
enabled) performs snapping by rounding Pos to the nearest TicGap. 

See also; TSlider::TicGap 

Protected data members 

TColor BkColor; 

Stores the background color of the slider. 

TRect CaretRect; 

Refers to the position of the caret's rectangle. 

int Max; 

Contains the maximum value of the slider position. 

int Min; 

Contains the minimum value of the slider position. 

static TSize MouseOffset; 

Statics used while the mouse is down and the thumb is sliding. 
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Pos 

Range 

SlideDC 

Sliding 

SlotThick 

Snap 

ThumbRect 

ThumbResId 

ThumbRgn 



TicGap 



int Pos; 

Indicates where the thumb is positioned on the slider. 

See also: T Slider r.GetPosition 

UINT Range; 

Contains the difference between the maximum and minimum range of the 
slider. 

static TDC* SlideDC; 

Statics used while the mouse is down and the thumb is sliding. 

BOOL Sliding; 

TRUE if the thumb is sliding. 

int SlotThick; 

Indicates the thickness of the slot. Set to 17 by default. 

BOOL Snap; 

TRUE if snapping is activated; otherwise FALSE. 

TRect ThumbRect; 

Holds the thumb's bounding rectangle. 

TResId ThumbResId; 

ThumbResId is the bitmap resource ID for the thumb knob. 

TRegion* ThumbRgn; 

Refers to the region, if any, that defines the thumb shape for this slider 
class. 

See also: TSlider::SetupThumbRgn 

int TicGap; 

Specifies the amount of space in pixels between ticks. 

Response table entries 



Response table entry 



Member function 



EV_WM_ERASEBKGND 
EV_WM_GETDLGCODE 
EV WM KEYDOWN 



EvEraseBkgnd 
EvGetDlgCode 
EvKeyDown 
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Response table entry 



Member function 



EV_WM_KILLFOCUS 

EV_WM_LBUTTONDBLCLK 

EV_WM_LBUTTONDOWN 

EV_WM_LBUTTONUP 

EV_WM_MOUSEMOVE 

EV_WM_PAINT 

EV_WM_SETFOCUS 

EV WM SIZE 



EvKillFocus 

EvLButtonDblClk 

EvLButtonDown 

EvLButtonUp 

EvMouseMove 

EvPaint 

EvSetFocus 

EvSize 



TSortedStringArray typedef 



validate.h 



typedef TSArrayAsVector<string> TSortedStringArray; 
TSortedStringArray implements a sorted list of ASCII strings. 
See also: TValidator, TLookupValidator 



TStatic class 



static.h 



A TStatic is an interface object that represents a static text interface element 
in Windows. It must be used to create a static control in a parent T Window. 
It can also be used to make it easier to modify the text of static controls in 
TDialogs. 

Public data members 



TextLen 



UINT TextLen; 

TextLen holds the size of the text buffer for static controls. The number of 
characters that can actually be stored in the static control is one less than 
TextLen because of the null terminator on the string. TextLen is also the 
number of bytes transferred by the Transfer member function. 



Public constructors 



Constructor TStatic (TWindow* parent, int Id, const char far* title, int x, int y, 

int w, int h, UINT textLen, TModule* module = 0); 

Constructs a static control object with the supplied parent window (parent), 
control ID (Id), text (title), position (x, y) relative to the origin of the parent 
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window's client area, width (w), height (h), and text length (textLen). By 
default, the static control is visible upon creation and has left-justified text. 
(Attr.Style is set to WS_CHILD I WS_VISIBLE I WS_GROUP I SS_LEFT.) 
Invokes a TControl constructor. 

See also: TControl::TControl 

Constructor TStatic (Window* parent, int resourceld, UINT textLen, 

TModule* module = 0) ; 

Constructs a TStatic object to be associated with a static control interface 
control of a TDialog. Invokes the TControl constructor with similar 
parameters, then sets TextLen to textLen. Disables the data transfer 
mechanism by calling DisableTransfer. 

The resourceld parameter must correspond to a static control resource that 
you define. 

See also: TControl: :TControl 

Public member functions 

Clear inline void Clear (); 

Clears the static control's text. 

GetText inline int GetText(char far* str, int maxChars); 

Retrieves the static control's text, stores it in the str argument of maxChars 
size, and returns the number of characters copied. 

GetTextLen inline int GetTextLen ( ) ; 

Returns the length of the static control's text. 

SetText inline void SetText (const char far* string); 

Sets the static control's text to the string supplied in str. 

Transfer inline virtual WORD Transfer (void* buffer, TTransferDirection direction); 

Transfers TextLen characters of text to or from a transfer buffer pointed to 
by buffer. If direction is tdGetData, the text is transferred to the buffer from 
the static control. If direction is tdSetData, the static control's text is set to the 
text contained in the transfer buffer. Transfer returns TextLen, the number of 
bytes stored in or retrieved from the buffer. If direction is tdSizeData, 
Transfer returns TextLen without transferring data. 



374 



ObjectWindows 2.0 Reference Guide 



TStatic class 



Protected member functions 



GetClassName 



virtual char far* GetClassName () ; 

Returns the name of TStatic's Windows registration class (STATIC), or 
returns STATIC CLASS if BWCC is enabled. 



TStatus class 



excepth 



Used primarily for backward compatibility with previous versions of 
ObjectWindows, TStatus is used by TModule and TWindow to indicate an 
error in the initialization of an interface object. If Status is set to a nonzero 
value, a TXCompatibility exception is thrown. 



Constructor 



Public constructors 



TStatusO; 

Constructs a TStatus object and initializes the status code to 0. 

See also: TModule: :Status, TWindow:: Status 



Public data members 



operators 
operator 



inline TStatus& operator=(int statusCode) ; 

Sets the status code and throws a TXCompatibility exception. 

inline operator int() const; 

Returns the status code. 



TStatusBar class 



statusba.h 



In contrast to plain message bars, status bars provide several display 
options. ObjectWindows status bars let you include multiple text gadgets 
(the text on the left of the status bar) and different border styles. You can 
also reserve space for mode indicators (the text that displays the program's 
current state, such as extended selection (of keys and other modes), 
CapsLock, NumLock, ScrollLock, Overwrite, and macro recording). TStatusBar 
creates text gadgets for the mode indicators you request and adjusts the 
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TModelndicator 
enum 



Constructor 



spacing between mode indicators. The TSpacing struct stores spacing and 
layout unit constraints. 

Like other control bars, the status bar is constructed and destroyed at the 
same time as its parent's window, but this is not a required procedure. 

The following program statements show how to construct a status bar and 
insert it at the bottom of the window. 

TStatusBar* sb = new TStatusBar (0, TGadget: : Recessed, 

TStatusBar: :CapsLock | TStatusBar: -.NumLock I 

TStatusBar: : Overtype ) ; 
frame->Insert (*sb, TDecoratedFrame: : Bottom) ; 

MainWindow - frame; 

See the MDIFILE.CPP sample program on your distribution disk for an 
example of how to create a window with a status bar. 

Public data members 

enum TModelndicator {ExtendSelection = 1, CapsLock = 1 « 1, 
NumLock = 1 « 2, ScrollLock = 1 « 3, 
Overtype = 1 « 4, RecordingMacro = 1 « 5}; 

Enumerates the program modes. By default, these are arranged 
horizontally on the status bar from left to right. 

Public constructors 

TStatusBar (TWindow* parent =0, 

TGadget: :TBorderStyle borderStyle = TGadget: -.Recessed, 

UINT modelndicators = 0, TFont *font = new TGadgetWindowFont , 

TModule* module = 0) ; 

Constructs a TStatusBar object in the parent window and creates any new 
gadgets and mode indicator gadgets. Sets BorderStyle to borderStyle, 
Modelndicators to modelndicators, and NumModelndicators to 0. Sets the 
values of the margins and borders depending on whether the gadget is 
raised, recessed, or plain. 

Public member functions 



Insert 



void Insert (TGadget& gadget, TPlacement ■- After, TGadget* sibling = 
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operator 



SetModelndicator 



Inserts the gadget in the status bar. By default, the new gadget is placed just 
after any existing gadgets and to the left of the status mode indicators. 

TTextGadget* operator [] (UINT index); 

Returns a gadget at a given index, but cannot access mode indicator 
gadgets. 

void SetModelndicator (TModelndicator, BOOL state); 

Sets TModelndicator to a given text gadget and set the status (on, by default) 
of the mode indicator. For the mode indicator to appear on the status bar, 
you must specify the mode when the window is constructed. 

See also: TStatusBar: -.TModelndicator, TKeyboardModeTracker::EvKeyDoivn 

ToggleModelndicator vo id ToggleModelndicator (TModelndicator) ; 

Toggles the Modelndicator. 

See also: TKeyboar dModeTr acker r.EvKey Down 

SetSpacmg inline void SetSpacing(TSpacing& spacing); 

Uses the TSpacing values to set the spacing to be used between mode 
indicator gadgets. TSpacing sets the status-bar margins in layout units. 
Typically, the message indicator (the leftmost text gadget) is left-justified on 
/ the status bar and the other indicators are right-justified. See TLayoutMetrics 
for an detailed explanation of layout units and constraints. 

struct TSpacing { 

TMargins: :TUnits Units; 

int Value; 

TSpacing () {Units = TMargins: :LayoutUnits; Value = 0;} 
}; 

See also: TStatusBar: -.TModelndicator 

Protected data members 



BorderStyle 



Modelndicators 



NumModelndicators 



TGadget: :TBorderStyle BorderStyle; 

One of the enumerated border styles — none, plain, raised, recessed, or 
embossed — used by the mode indicators on the status bar. 

UINT Modelndicators; 

The Modelndicators bit field indicates which mode indicators have been 
created for the status bar. 

UINT NumModelndicators; 
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Spacing 



Specifies the number of mode indicators, which can range from 1 to 5. 

TSpacing Spacing; 

Specifies the spacing between mode indicators on the status bar. 



Protected member functions 



PositionGadget vo i(j p sitionGadget(TGadget* previous, TGadget* next, TPointk point); 

Determines the position of the new gadget in relation to any previously 
existing gadgets and uses the Pixels, LayoutUnits, and BorderUnits fields of 
TMargins to determine the amount of spacing to leave between the mode 
indicators. 



TStream class 



docview.h 



An abstract base class, TStream provides links between streams and 
documents, views, and document files. 

Public data members 



Open Mode 



StreamName 



int OpenMode; 

Holds mode flags used when opening document streams. For example, the 
stream can be opened in ofRead mode to allow reading, but not changing 
(writing to) the file. 

See also: ofxxxx document open enum 

LPCSTR StreamName; 

Holds the name of the stream used for opening the document. 



Destructor 



Public destructor 



inline ~TStream( 



Closes the stream. Derived classes generally close the document if it was 
opened especially for this stream. 
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Public member functions 



GetDocument inline TDocumentk GetDocument () ; 

Returns the current document open for streaming 

Protected data members 



Doc TDocument& Doc- 

Stores the document that owns this stream. 

NextStream TStream* NextStream; 

Points to the next stream in the list of active streams. 

Protected constructors 



Constructor TStream (TDocumentk doc, LPCSTR name,int mode); 

Constructs a TStream object, doc refers to the document object, name is the 
user-defined name of the stream, and mode is the mode used for opening 
the stream. 

See also: TInStream, TOutStream, ofXXXX document open enum, shdocument 
sharing enum 



TStringLookupValidator class 



validate.h 



Derived from TLookupValidator, TStringLookupValidator is a streamable class. 
A TStringLookupValidator object verifies the data in its associated edit 
control by searching through a collection of valid strings. You can use 
string-lookup validators when your edit control needs to accept only 
members of a certain set of strings. 

Public constructors and destructor 



Constructor 



Destructor 



TStringLookupValidator (TSortedStringArray strings) ; 

Constructs a string-lookup object by first calling the constructor inherited 
from TLookupValidator and then setting Strings to strings. 

-TStringLookupValidator () ; 
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Error 



Lookup 



NewStringList 



Strings 



Disposes of a list of valid strings by calling NewStringList and then disposes 
of the string-lookup validator object by calling the destructor inherited 
from TLookupValidator. 

Public member functions 

void Error ( ) ; 

Overrides TValidator's virtual function and displays a message box 
indicating that the typed string does not match an entry in the string list. 

See also: TValidator::Error 

BOOL Lookup (const char far* str); 

Overrides TLookupValidator's virtual function. Returns TRUE if the string 
passed in str matches any of the strings. Uses the search method of the 
string collection to determine if str is present. 

See also: TLookupValidator: -.Lookup 

void NewStringList (TSortedStringArray strings); 

Sets the list of valid input string for the string-lookup validator. Disposes of 
any existing string list and then sets Strings to strings. 

Protected data member 

TSortedStringArray Strings; 

Points to a string collection containing all the valid strings the user can 
type. If Strings is NULL, all input is validated. 



TSystemMenu class 



menu.h 



TSystemMenu creates a system menu object that then becomes the existing 
system menu. See Chapter 7 in the ObjectWindows Programmer's Guide for 
more information about menu objects. 

Public constructors 



Constructor 



TSystemMenu (HWND wnd, BOOL revert = FALSE) 
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Constructs a system menu object. If revert is TRUE, then the menu created 
is a default system menu. Otherwise, it is the menu currently in the 
window. 

See also: TPopupMenu::TPopupMenu 



TTextGadget class 



textgadg.h 



Derived from TGadget, TTextGadget is a text gadget object. When you 
construct a text gadget, you must specify how many characters you want to 
reserve space for and how the text should be aligned horizontally. The 
inner boundaries of the text gadget are computed by multiplying the 
number of characters by the maximum character width. 

Public data members 



TAIign 



enum TAlign (Left, Center, Right}; 

Enumerates the text-alignment attributes. Left aligns the text at the left edge 
of the bounding rectangle. Right aligns the text at the right edge of the 
bounding rectangle. Center aligns the text horizontally at the center of the 
bounding rectangle. 

Public constructors 



Constructor TTextGadget (int id = 0, TBorderStyle = Recessed, TAlign = Left, UINT 

numChars = 10, const char* text = 0); 

Constructs a TTextGadget object with the specified ID, border style, and 
alignment. Sets Mar gins. Left and Mar gins. Right to 2. Sets Text and TextLen 
toO. 

Public member functions 



GetText 



SetText 



inline char* GetText (); 
Returns the text for the gadget. 

void SetText (const char* text); 
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If the text stored in Text is not the same as the new text, SetText deletes the 
text stored in Text . Then, it sets TextLen to the length of the new string. If no 
text exists, it sets both Text and TextLen to and then calls Invalidate to 
invalidate the rectangle. 

Protected data members 



Align 

NumChars 
Text 
TextLen 



TAlign Align; 

Text alignment attribute — left, center, or right-aligned. 

UINT NumChars; 

Holds the number of text characters. 

char* Text; 

Points to the text for the gadget. 

UINT TextLen; 

Stores the length of the text. 



Protected member functions 



GetDesiredSize 



Invalidate 



Paint 



void GetDesiredSize (TSize &size) ; 

If shrink-wrapping is requested, GetDesiredSize returns the size needed to 
accommodate the borders, margins, and text; otherwise, if shrink-wrapping 
is not requested, it returns the gadget's current width and height. 

See also: TGadgetr.GetDesiredSize 

void Invalidate () ; 

Calls TGadget::GetInnerRect to compute the area of the text for the gadget 
and then TGadget::InvalidateRect to invalidate the rectangle in the parent 
window. 

See also: TGadgetv.GetlnnetRect, TGadget: Invalidate 

void Paint (TDC& dc); 

Calls TGadgetr.PaintBorder to paint the border. Calls TGadget::GetInnerRect to 
calculate the area of the text gadget's rectangle. If the text is left-aligned, 
Paint calls dc.GetTextExtent to compute the width and height of a line of the 
text. To set the background color, Paint calls dc.GetSysColor and sets the 
default background color to face shading (COLOR_BTNFACE). To set the 
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button text color, Paint calls dc.SetTextColor and sets the default button text 
color to COLOR_BTNTEXT. To draw the text, Paint calls dc.ExtTextOut and 
passes the parameters ETO_CLIPPED (so the text is clipped to fit the 
rectangle) and ETO_OPAQUE (so the rectangle is filled with the current 
background color). 

See also: TGadget::Paint 

TTileDirection enum gadgetwi.h 

Enumerates the horizontal and vertical direction for tiling the gadget. 

enum TTileDirection; 

See also: TGadget Window: -.Direction 

TTinyCaption class tinycapt.h 

Derived from TWindow, TTinyCaption is a mix-in class that handles a set of 
non-client events to produce a smaller caption bar for a window. Whenever 
it displays the caption bar, TTinyCaption checks the window style and 
handles the Windows WS_SYSMENU, WSJVIINIMIZEBOX, 
WS_MAXIMIZEBOX display attributes. Thus, you can use TTinyCaption to 
set the attributes of the tiny caption bar before enabling the caption. For 
example, 

Attr. Style = WS_P0PUP I WS_B0RDER I WS_SYSMENU I WS_MINIMIZEBOX | 
WS_MAXIMIZEBOX; 

TTinyCaption provides functions that let you manipulate Windows frame 
types, border styles, and menus. You can adjust the height of the caption 
bar or accept the default height/which is about one-half the height of a 
standard caption bar. If you set CloseBox to TRUE,then the window will 
close when you click the close box instead of displaying the system menu. 

OWLCMD.CPP, in your OWLAPPSXOWLCMD directory, displays the 
following tiny caption bar: 



Close List Minimize 

box box box 

gH51aflimMMffliM5BMaia» 



Dir| 
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Border 

CaptionHeight 

CaptionFont 

CloseBox 

Down Hit 

Frame 

isPressed 

TCEnabled 

WaitingForSysCmd 



If you are using TTinyCaption as a mix-in class that does partial event 
handling, call the DoXxxx function in the mix-in class (instead of the 
EvXxxx function) to avoid duplicating default processing. The following 
example from OWLCMD.CPP (a sample program on your distribution 
disk) illustrates this process: 

void TMyFrame: :EvSysCommand(UINT cmdType,TPoint& p) 



if (TTinyCaption: :DoSysCommand(cmdType, p) 
TFrameWindow: :EvSysCommand(cmdType, p) ; 



esPartial) 



The TFLoatingFrame class can be used with TTinyCaption to produce a close 
box. See the sample programs OWLCMD.CPP and MDIFILE.CPP on your 
distribution disk for examples of how to use TTinyCaption. 

Protected data members 

TSize Border; 

Thin frame border size for dividers. 

int CaptionHeight; 

Height of the caption bar. 

TFont* CaptionFont; 

Font used for the text in the tiny caption bar. 

BOOL CloseBox; 

If TRUE, the window will close when the close box is clicked. 

UINT DownHit; 

Location of mouse-button press or cursor move. 

TSize Frame; 

Actual left and right, top and bottom dimensions of the caption bar. 

BOOL IsPressed; 

Is TRUE if a mouse button is pressed. 

BOOL TCEnabled; 

Is TRUE if the tiny caption bar is displayed. 

BOOL WaitingForSysCmd; 

Is TRUE if TTinyCaption is ready to receive system messages. 
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Protected constructors and destructor 



Constructor 



Destructor 



TTinyCaptionO : 

Constructs a TTinyCaption object attached to the given parent window. 
Initializes the caption font to and TCEnabled to FALSE so that the tiny 
caption bar is not displayed automatically. 

-TTinyCaptionO : 

Destroys a TTinyCaption object and deletes the caption font. 



Protected member functions 



DoCommand 



DoLButtonUp 



DoMouseMove 



DoNCActivate 



DoNGCaicSize 



TEventStatus DoCommand (JJINT id, HWND hWndCtl, UINT notifyCode, LRESULT& 
evRes) ; 

Displays the system menu using r.TrackPopup so that TTinyCaption sends . 
WM_COMMAND instead of WM_SYSCOMMAND messages. If a system 
menu command is received, it's then transformed into a 
WM_SYSCOMMAND message. If the tiny caption bar is FALSE, 
DoCommand returns esPartial. 

See also: TTinyCaptionr.EvCommand, TEventStatus enum 

TEventStatus DoLButtonUp (UINT hitTest, TPointk screenPt); 

Releases the mouse capture if the caption bar is enabled and a mouse 
button is pressed. Sets hitTest, indicating the mouse button has been 
pressed. Captures the mouse message and repaints the smaller buttons 
before returning esComplete. 

See also: TTinyCaption: :EvLButtonUp 

TEventStatus DoMouseMove (UINT hitTest, TPointk screenPt); 
Returns TEventStatus. 

TEventStatus DoNCActivate (BOOL active, B00L& evRes) ; 

If the tiny caption is not enabled or is iconic, returns esPartial. Otherwise, 
repaints the caption as an active caption and returns esComplete. 

See also: TTinyCaption: :EvNC Activate 

TEventStatus DoNCCalcSize(BOOL calcValidRects, 

NCCALCSIZE_PARAMS far&calcSize, UINT& evRes); 

If the caption bar is not enabled or is iconic, returns esPartial. Otherwise, 
calculates the dimensions of the caption and returns esComplete. 
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DoNCHitTest 



DoNCLButtonDown 



DoNCPaint 



DoSysCommand 



DoSysMenu 



See also: TTinyCaptionr.EvNCCalcSize 

TEventStatus DoNCHitTest (TPoint& screenPt, UTNT& evRes) ; 

If the caption bar is not enabled, returns esPartial. Otherwise, sends a 
message to the caption bar that the mouse or the cursor has moved, and 
returns esComplete. 

See also: TTiny Caption: :EvNCHitTest 

TEventStatus DoNCLButtonDown (UINT hitTest, TPointk screenPt); 

If the caption bar isn't enabled, returns esPartial. Otherwise, determines if 
the user released the button outside or inside a menu, and returns 
esComplete. 

See also: TTiny Caption: :EvNCLButtonDown 

TEventStatus DoNCPaint (); 

If the caption bar isn't enabled or is iconized, returns esPartial. Otherwise, 
gets the focus, paints the caption, and returns esPartial, thus indicating that 
a separate paint function must be called to paint the borders of the caption. 

See also: TTiny Caption: :EvNCPaint 

TEventStatus DoSysCommand (UINT cmdType, TPoint& p) ; 

If the caption bar isn't enabled, returns esPartial. If the caption bar is 
iconized and the user clicks the icon, calls DoSysMenu to display the menu 
in its normal mode and returns esComplete. 

See also: TTinyCaptionr.EvSysCommand 

void DoSysMenu ( ) ; 

Returns a handle to the system menu and makes a copy of the system 
menu. 



EnableTinyCaption void EnableTinyCaption(int ch=45 ; BOOL closeBox=FALSE) ; 

Activates the tiny caption bar. By default, EnableTinyCaption replaces the 
system window with a tiny caption window that doesn't close when the 
system window is clicked. If the closeBox argument is TRUE, clicking on the 
system menu will close the window instead of bringing up the menu. You 
can use EnableTinyCaption to hide the window if you are using a tiny 
caption in a derived class. To diminish the tiny caption bar, try the 
following values: 

EnableTinyCaption (30, TRUE) ; 
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EvCommand 



EvLButtonUp 



EvMouseMove 



EvNCActivate 



EvNCCalcSize 



EvNCHitTest 



EvNCLButtonDown 



Or, to maximize the tiny caption bar, use these values: 

EnableTinyCaption(48, TRUE); 

LRESULT EvCommand (UINT id, HWND hWndCtl, UINT notifyCode) ; 

EvCommand provides extra processing for commands, but lets the focus 
window and its parent windows handle the command first. 

See also: TTinyCaption: :DoCommand 

void EvLButtonUp (UINT. hitTest, TPoint& screenPt) ; 

Responds to a mouse button-up message by calling DoLButtonllp. If 
DoLButtonllp doesn't return IsComplete, EvLButtonUp calls 
T Window "EvLButtonUp. 

See also: TTinyCaptionr.DoLButtonUp 

void EvMouseMove (UINT hitTest, TPointk screenPt); 

Responds to a mouse-move message by calling DoMouseMove. If 
DoMouseMove doesn't return IsComplete, EvMouseMove calls 
TWindow::EvMouseMove. 

See also: TTinyCaption -.-.DoMouseMove 

BOOL EvNCActivate (BOOL active); 

Responds to a request to change a title bar or icon by calling DoNCActivate. 
If DoNCActivate doesn't return esComplete, EvNCActivate calls 
T Window: -.EvNCActivate. 

See also: TTinyCaption: :DoNC Activate 

UINT EvNCCalcSize (BOOL calcValidRects, NCCALCSIZE_PARAMS far& calcSize) ; 

Responds to a request to change a title bar or icon by calling DoNCActivate. 
If DoNCActivate doesn't return esComplete, EvNCActivate calls 
TWindowr.EvNCActivate. 

Calculates the size of the command window including the caption and 
border so that it can fit within the window. 

See also: TTinyCaption: :DoNC Activate 

UINT EvNCHitTest (TPoint& screenPt); 

Responds to a cursor move or press of a mouse button by calling 
DoNCHitTest. If DoNCHitTest doesn't return esComplete, EvNCHitTest calls 
TWindow::EvNCHitTest. 

See also: TTinyCaption: -.DoNCHitTest 

void EvNCLButtonDown (UINT hitTest, TPointk screenPt); 
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EvNCPaint 



EvSysCommand 



GetCaptionRect 



GetMaxBoxRect 



GetMinBoxRect 



GetSysBoxRect 



PaintButton 



PaintCaption 



Responds to a press of the left mouse button while the cursor is within the 
nonclient area of the caption bar by calling DoNCLButtonDown. If 
DoNCLButtonDown doesn't return esComplete, EvNCLButtonDown calls 
TWindowr.EvNCLButtonDown. 

See also: TTinyCaption: -.DoNCLButtonDown 

void EvNCPaint ( ) ; 

Responds to a request to change a title bar or icon by calling DoNCActivate. 
If DoNCActivate doesn't return esComplete, EvNCActivate calls 
TWindow::EvNC Activate. 

Calls T Window:: EvNCPaint to paint the indicated device context or display 
screen. 

See also: TTinyCaption: :DoNC Activate 

void EvSysCommand (UINT cmdType, TPoint& p) ; 

Responds to a WM_SYSCOMMAND message by calling DoSysCommand. If 
DoSysCommand returns esPartial, EvSysCommand calls 
TWindow: -.EvSysCommand. 

See also: TTinyCaptionr.DoSysCommand 

TRect GetCaptionRect () ; 

Gets the area of the caption for changing or repainting. 

See also: TTinyCapr.PaintCaption 

TRect GetMaxBoxRect ( ) ; 

Returns the size of the maximize box rectangle. 

See also: TTinyCapr.PaintMaxBoxRect 

TRect GetMinBoxRect ( ) ; 

Returns the size of the minimize box rectangle. 

See also: TTinyCap::PaintMinBoxRect 

TRect GetSysBoxRect () ; 

Returns the size of the system box rectangle. 

See also: TTinyCapr.PaintSysBoxRect 

void PaintButton (TDC& dc, TRect& boxRect, BOOL pressed); 

Paints a blank button. 

void PaintCaption (TWindowDC &) ; 
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PaintCloseBox 



PaintMaxBox 



PaintMinBox 



PaintSysBox 



Calls dc.SelectObject to select the given rectangle and dc.PatBU to paint the 
tiny caption bar using the currently selected brush for this device context. 

See also: TDC::SelectObject , TDCr.PatBlt 

void PaintCloseBox (TDC& dc, TRect& boxRect, BOOL pressed); 

Paints a close box on the tiny caption bar. You can override the default box 
if you want to design your own close box. 

See also: TTinyCapr.GetSysBoxRect 

void PaintMaxBox (TDC& dc, TRect& boxRect, BOOL pressed); 

Paints a maximize box on the tiny caption bar. 

See also: TTinyCapr.GetMaxBoxRect 

void PaintMinBox (TDC& dc, TRectk boxRect, BOOL pressed); 

Paints a minimize box on the tiny caption bar. 

See also: TTinyCap::GetMinBoxRect 

void PaintSysBox (TDC& dc, TRect& boxRect, BOOL pressed); 

Paints the system box 

See also: TTinyCap::GetSysBoxRect 



Response table entries 



Response table entry 



Member function 



EV_WM_NCACTIVATE 

EV_WM_NCCALCSIZE 

EV_WM_NCHITTEST 

EV_WM_NCPAINT 

EV_WM_NCLBUTTONDOWN 

EV_WM_LBUTTONUP 

EV_WM_MOUSEMOVE 

EV WM SYSCOMMAND 



EvNCActivate 

EvNcCalcSize 

EvNcHitTest 

EvNcPaint 

EvNclButtonDown 

EvLButtonllp 

EvMouseMove 

EvSysCommand 



TToolBox class 



toolbox.h 



Derived from TGadget Window, TToolBox arranges gadgets in a matrix in 
which all columns are the same width (as wide as the widest gadget) and 
all rows are the same height (as high as the highest gadget). 
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You can specify exactly how many rows and columns you want for your 
toolbox, or you can let TToolbox calculate the number of columns and rows 
you need. If you specify AS_MANY_AS_NEEDED, the TToolBox calculates 
how many rows or columns are needed based on the opposite dimension. 
For example, if there are twenty gadgets, and you requested four columns, 
your matrix would have five rows. 

Public constructors 



Constructor TToolBox(TWindow* parent, int numColumns = 2, 

int numRows = AS_MANY_AS_NEEDED, 
TTileDirection direction = Horizontal, TModule* module = 0); 

Constructs a TToolBox object with the specified number of columns and 
rows and tiling direction. Overlaps the borders of the toolbox with those of 
the gadget and sets ShrinkWrapWidth to TRUE. 



Public member functions 



GetDesiredSl'ze void GetDesiredSize(TSize& size); 

Overrides TGadget's GetDesiredSize function and computes the size of the 
cell by calling GetMargins to get the margins. 

See also: TGadgetWindozv::GetDesiredSize 

Insert void Insert (TGadget& gadget, TPlacement = After, TGadget* sibling = 0); 

Overrides TGadget's Insert function and tells the button not to notch its 
corners. 

See also: TGadgetWindow::Insert 

SetDirectlon virtual void SetDirection (TTileDirection direction); 

Sets the direction of the tiling — either horizontal or vertical. 



Protected data members 



NumColumns 



NumRows 



int NumColumns; 

Contains the number of columns for the toolbox. 

int NumRows; 
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Contains the number of rows for the toolbox. 

Protected member functions 



TileGadgetS TRect TileGadgetsO ; 

Tiles the gadgets in the direction requested (horizontal or vertical). 
Calls PositionGadget to give derived classes an opportunity to adjust the 
spacing between gadgets. 

See also: TGadget Window: :TileGadget 

TTransferDirection enum window.h 

TTransferDirection enum describes the following constants, which the 
transfer functions uses to determine how to transfer data to and from the 
transfer buffer. 

Table 1.29 Constant Meaning 

Transfer function 

constants tdGetData Retrieve data from the class. 

tdSetData Send data to the class. 

tdSizeData Return the size of data transferred by the class. 

See also: TWindow::Transfer, TWindow::TransferData 

TValidator class validate.h 

A streamable class, TValidator defines an abstract data validation object. 
Although you will never actually create an instance of TValidator, it 
provides the abstract functions for the other data validation objects. 

The VALID ATE.CPP sample program on your distribution disk derives 
TVAlidateApp from T Application in the following manner: 

class TValidateApp : public TApplication { 
public: 
TValidateApp () : TApplication ("ValidateApp") {} 
void InitMainWindowO { 
MainWindow = new TTestWindow(0, "Validate Dialog Input"); 
} 
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and displays the following message box if the user enter an invalid 
employee ID: 



Main application window 




After you choose 
InputlEmployee from 
the menu, the 
Employee Data 
Entry dialog box 
appears. 



If an invalid employee 
ID is entered, the 
ValidateApp message 
box appears. 



Constructor 



Destructor 



Public constructors and destructor 



TValidator(); 

Constructs an abstract validator object and sets Options fields to 0. 

virtual ~TValidator() {} 

Destroys an abstract validator object. 



Public member functions 



Error 



HasOption 



virtual void Error (); 

Error is an abstract function called by Valid when it detects that the user has 
entered invalid information. By default, TValidator "Error does nothing, but 
derived classes can override Error to provide feedback to the user. 

inline BOOL HasOption (int option); 

Gets the Options bits. Returns TRUE if a specified option is set. 

See also: TValidator: -.Options, Voxxxx constants 
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IsValid 



IsValidlnput 



SetOption 



Transfer 



virtual BOOL IsValid(const char far* str) ; 

By default, TValidator.IsValid returns.TRUE. Derived validator types can 
override IsValid to validate data for a completed edit control. If an edit 
control has an associated validator object, its Valid method calls the 
validator object's Valid method, which in turn calls IsValid to determine 
whether the contents of the edit control are valid. 

See also: TVaiidator -.Valid 

virtual BOOL IsValidlnput (char far* str, BOOL suppressFill); 

If an edit control has an associated validator object, it calls IsValidlnput after 
processing each keyboard event. This gives validators such as filter 
validators an opportunity to catch errors before the user fills the entire item 
or screen. 

By default, IsValidlnput returns TRUE. Derived data validators can override 
IsValidlnput to validate data as the user types it, returning TRUE if str holds 
valid data and FALSE otherwise. 

str is the current input string. suppressFill determines whether the validator 
should automatically format the string before validating it. If suppressFill is 
TRUE, validation takes place on the unmodified string str. If suppressFill is 
FALSE, the validator should apply any filling or padding before validating 
data. Of the standard validator objects, only TPXPictureValidator checks 
suppressFill. 

IsValidlnput can modify the contents of the input string; for example, it can 
force characters to uppercase or insert literal characters from a format 
picture. IsValidlnput should not, however, delete invalid characters from the 
string. By returning FALSE, IsValidlnput indicates that the edit control 
should erase the incorrect characters. 

inline void SetOption(int option); 

Sets the bits for the Options data member. 

See also: TValidatorr.Options, Voxxxx constants 

virtual UINT Transfer (char far* str, void* buffer, 

TTransferDi recti on direction) ; 

Allows a validator to set and read the values of its associated edit control. 
This is primarily useful for validators that check non-string data, such as 
numeric values. For example, TRangeValidator uses Transfer to read and 
write values instead of transferring an entire string. 
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By default, edit controls with validators give the validator the first chance 
to respond to DataSize, GetData, and SetData by calling the validator's 
Transfer method. If Transfer returns anything other than 0, it indicates to the 
edit control that it has handled the appropriate transfer. The default action 
of TV r alidator -.Transfer is to always return 0. If you want the validator to 
transfer data, you must override its Transfer method. 

Transfer's first two parameters are the associated edit control's text string 
and the tdGetData or tdSetData data record. Depending on the value of 
direction, Transfer can set str from buffer or read the data from str into buffer. 
The return value is always the number of bytes transferred. 

If direction is tdSizeData, Transfer doesn't change either str or buffer; it just 
returns the data size. If direction is tdSetData, Transfer reads the appropriate 
number of bytes from buffer, converts them into the proper string form, and 
sets them into str, returning the number of bytes read. If direction is 
tdGetData, Transfer converts str into the appropriate data type and writes 
the value into buffer, returning the number of bytes written. 

See also: TTransferDirection enum 

UnsetOption inline void UnsetOption(int option); 

Unsets the bits specified in the Options data member. 

See also: TValidatorr.Options, Voxxxx constants 

Valid inline BOOL Valid (const char far* str); 

Returns TRUE if IsValid returns TRUE. Otherwise, calls Error and returns 
FALSE. A validator's Valid method is called by the Valid method of its 
associated edit control. 

Edit controls with associated validator objects call the validator's Valid 
method under two conditions. The first condition is when the edit control's 
ofValidate option is set and the edit control calls Valid when it loses focus. 
The second condition is when the dialog box that contains the edit control 
calls Valid for all its controls, usually because the user requested to close the 
dialog box or to accept an entry screen. 

Protected data members 

Options WORD Options; 

Options is a bitmap member used to control options for various 
descendants of TValidator. By default, the TValidator constructor clears all 
the bits in Options. 
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TValidator: :TXValidator class 
See also: voxxxx constants, TValidatorr.SetOption, TValidator: -.UnsetOption 

TValidator: :TXValidator class validate.h 

A nested class, TXValidator describes an exception that results from an 
invalid validator object. 

Public constructors 

Constructor TXValidator(UINT resld = IDS_VALIDATORSYNTAX ); 

Constructs a TXValidator object, setting the resource ID to 
IDS_VALIDATORSYNTAX. 

TVbxControl class vbxctl.h 

Derived from TControl, TVbxControl provides the interface for Visual Basic 
(VBX) controls. You can use this class to get or set the properties of VBX 
controls. Under certain conditions, you can also use additional methods for 
processing controls. 

You can manipulate the control's properties using either an index value or a 
name. Several overloaded GetProp functions are provided so that you can 
access different types of properties. Similarly, several overloaded SetProp 
functions let you set the properties of controls using either the name of the 
VBX control or the index value. Consult the documentation for your VBX 
controls to find the name that corresponds to the property you want to 
manipulate. 

The VBXCTLX.CPP sample program on your distribution disks displays 
the following VBX controls: 
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Click Test to display 
the VBX controls 

Pictures 




Switches 



Constructor 



Constructor 



If you want the TVbx control object to process VBX events, you must derive 
a class from TVbxControl and add a response table that has entries for the 
events you want processed. For information about creating response tables 
and handling VBX messages, see TVbxEventHandler. 

For more information about how to design programs that use VBX controls, 
see Chapter 15 in the ObjectWindows Programmer's Guide. 

Public constructors and destructor 

TVbxControl (TWindow* parent, int id, const char far* vbxName, const char 
far* vbxClass, const char far* title, int x, int y, int .w, int 
h, TModule* module =0); 

Constructs a VBX control where parent points to the parent window, id is 
the control's ID, vbxName is the name of the file containing the VBX control, 
vbxClass is the VBX class name, title is the control's caption, x and y are the 
coordinates in the parent window where the controls are to be placed, w 
and h are the width and height of the control, and module is the library 
resource ID for the control. 

TVbxControl (TWindow* parent, int resourceld, TModule* module = 0); 

If a VBX control is part of a dialog resource, its ID can be used to construct 
a corresponding (or alias) ObjectWindows object. You can use this 
constructor if a VBX control has already been defined in the application's 
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Destructor 



resource file, resourceld is the resource ID of the VBX control in the resource 
file. 

-TVbxControl ( ) ; 

Destroys the TVbxControl object. 



Public member functions 



Addltem inline BOOL Addltem(int index, const char far* item); 

Adds an item (item) to the list of VBX control items at the specified index 
(index). Returns nonzero if successful. 

Drag BOOL Drag(int action); 

Controls the drag and drop state of the VBX control according to the value 
of action, which can be (cancel a drag operation), 1 (begin dragging a 
control), or 2 (end dragging a control). 

GetEventlndex inline int GetEventlndex (const char far* name); 

Returns the index of the event associated with the name of the event passed 
in name. Returns -1 if an error occurs. 

GetEventName inline const char far* GetEventName(int event index ) ; 

Returns a string containing the name of an event associated with the 
integer event index number (eventindex). Returns if an error occurs. 

GetHCTL hctl GetHCTLO 

Returns a handle to a VBX control associated with this TVbxControl object. 
GetNumEventS inline int GetNumEvents ( ) ; 

Returns the total number of events associated with the VBX control. 

GetNumProps inline int GetNumPropsO ; 

Returns the total number of properties associated with the VBX control. 

GetProp inline BOOL GetProp(int proplndex, int& value, int arraylndex = -1) ; 

Gets an integer property value. An overloaded function, GetProp gets a 
VBX control property using an index value, proplndex is the index value of 
the property whose value you want to get. value is a reference to the 
variable that will receive the property values, arraylndex, an optional 
argument, specifies the position of the value in an array property if the 
property is an array type. If the property isn't an array type, arraylndex 
defaults to -1. See the third-party reference guide for your VBX controls to 
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GetProp 
GetProp 

GetProp 
GetProp 
GetProp 

GetProp 



GetProp 

GetProp 

Getprop 
Getprop 



determine a property's data type. GetProp returns nonzero if successful. To 
get the property by specifying the property index, use one of the following 
six GetProp functions. 

inline BOOL GetProp(int proplndex long& value, int arraylndex = -1); 

Gets a long property value. 

BOOL GetProp (int proplndex, ENUM& value, int arraylndex=-l) ; 

Gets an enumerated property value. For example, a list of options 
associated with a font style might be defined as an enumerated type. 

BOOL GetProp(int proplndex, HPIC& value, int arraylndex=-l) ; 

Gets a picture (value). HPIC is a handle to the picture. 

inline BOOL GetProp(int proplndex floats value, int arraylndex = -1); 

Gets a floating-point property value. 

inline BOOL GetProp(int proplndex strings value, int arraylndex = -1); 

Gets a string property value. 

See also: TVbxControl::SetProp 

inline BOOL GetProp (const char far* name, int& value, 
int arraylndex = -1); 

Returns an integer data value. An overloaded function, GetProp gets a VBX 
control property, proplndex is the index value of the property whose value 
you want to get. value is a reference to the variable that will receive the 
property value, arraylndex, an optional argument, specifies the position of 
the value in an array property if the property is an array type. If the 
property isn't an array type, arraylndex defaults to -1. GetProp returns 
nonzero if successful. To get the property by specifying the name of the 
property, use one of the following five GetProp functions. 

inline BOOL GetProp (const char far* name, long& value, 
int arraylndex = -1); 

Gets a long property value. 

inline BOOL GetProp (const char far* name, floats value, 
int arraylndex = -1); 

Gets a floating-point property value. 

BOOL Getprop (const char far* name, ENUM& value, int arraylndex=-l) ; 
Gets an enumerated property value. 

BOOL Getprop(const char far* name, HPIC& value, int arraylndex=-l) ; 
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GetProplndex 



GetPropName 



GetPropType 
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Gets a picture (value) property value. HPIC is a handle to the picture. 

inline BOOL GetProp (const char far* name, string& value, 
int arraylndex = -1); 

Gets a string property value. 

See also: TVbxControl::SetProp 

inline int GetProplndex (const char far* name); 

Gets the integer index value for the property name passed in name. Returns 
-1 if an error occurs. This usually indicates that the property name passed 
in name couldn't be located. 

const char far* GetPropName (int index); 

Gets the name for the property index passed in index. Returns if an error 
occurs. 

inline int GetPropType (int index); 

Gets the type for the property specified by index. Returns if an error 
occurs. The following table lists the names of the property types and their 
corresponding C++ data types. 



Table 1.30 
Property and C++ 


Property type 


C++ type 






types 


PTYPE_CSTRING 


HSZ 




PTYPE_SHORT 


short 




PTYPE_LONG 


LONG 




PTYPE_BOOL 


BOOL 




PTYPE_COLOR 


DWORD or COLORREF 




PTYPE_ENUM 


BYTE or ENUM 




PTYPE_REAL 


float 




PTYPE_XPOS 


LONG (Twips) 




PTYPE_XSIZE 


LONG (Twips) 




PTYPE_YPOS 


LONG (Twips) 




PTYPE YSIZE 


LONG (Twips) 




PTYPE_PICTURE 


HPIC 




PTYPE BSTRING 


HLSTR 



IsArrayProp 



Method 



Move 



inline BOOL IsArrayProp (int index); 

Returns TRUE if the property specified by index is an array property. 

inline BOOL Method(int method, long far* args); 

Used for invoking customized methods, Method returns TRUE if a VBX 
control can respond to the specified method (method). 

inline BOOL Move(int x, int y, int w, int h) ; 
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Refresh 



Removeltem 



SetProp 



SetProp 
SetProp 
SetProp 
SetProp 
SetProp 

SetProp 



SetProp 



Moves a VBX control to the coordinates specified in x and y, which 
designate the upper left corner screen coordinates. Resizes the VBX control 
to w pixels wide by h pixels high. Returns nonzero if successful. 

inline BOOL Refresh!) ; 

Repaints the control's display area. 

inline BOOL Removeltem (int index); 

Removes an item (specified by index). The item could be removed from a 
list box, a combo box, or a database, for example. 

inline BOOL SetProp(int proplndex, int value, int arraylndex = -1); 

Sets the property to an integer value. An overloaded function, SetProp sets a 
VBX control property, proplndex is the index number of the property whose 
value you want to set. value specifies the new value for the property. 
arraylndex specifies the position of the value in an array property if the 
property is an array type. If the property isn't an array type, arraylndex 
defaults to -1. To set the property by passing the property's index value, 
use one of the following six SetProp functions. 

inline BOOL SetProp(int proplndex, long value, int arraylndex = -1); 

Sets the property to a long value. 

BOOL SetProp(int proplndex, ENUM value, int array Index=-i) ; 

Sets the property to an enumerated value. 

BOOL SetProp(int proplndex, HPIC value, int arraylndex=-l) ; 

Sets a picture to an HPIC, or picture, value. 

inline BOOL SetProp(int proplndex, float value, int arraylndex = -1); 

Sets the property to a floating-point value. 

inline BOOL SetProp (int proplndex, const strings value, 
int arraylndex - -1) ; 

Sets the property to a string value. 

inline BOOL SetProp (int proplndex, const char far* value, 
int arraylndex = -1); 

Sets the property to a character string value. 

See also: TVbxControl: -.GetProp 

inline BOOL SetProp(const char far* name, int value, int arraylndex = -1); 
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SetProp 

SetProp 
SetProp 
SetProp 

SetProp 

SetProp 



GetClassName 



GetVBXProperty 



PerformCreate 



Sets the property to an integer value. An overloaded function, SetProp sets a 
VBX control property, array Index specifies the position of the value in an 
array property if the property is an array type. If the property isn't an array 
type, arraylndex defaults to -1. To set the property by using the property's 
name, use one of the following six SetProp functions. 

inline BOOL SetProp (const char far* name, long value, 
int arraylndex = -1) ; 

Sets the property to a long value. 

BOOL SetProp(int proplndex, ENUM value, int arraylndex=-l) ; 

Sets the property to an enumerated value. 

BOOL SetProp(int proplndex, HPIC value, int arraylndex = -1); 

Sets the picture property to an HPIC, or picture, value. 

inline BOOL SetProp (const char far* name, float value, 
int arraylndex = -1); 

Sets the property to a floating-point value. 

inline BOOL SetProp (const char far* name, const stringk value, 
int arraylndex = -1); 

Sets the property to a string value. 

inline BOOL SetProp (const char far* name, const char far* value, 
int arraylndex = -1); 

Sets the property to a character string value. 

Protected member functions 

char far* GetClassName () ; 

Gets the name of the VBX window class. 

BOOL GetVBXProperty (int proplndex, void far* value, int arraylndex = -1) ; 

Returns nonzero if the specified property exists, proplndex specifies the 
index value of the integer property whose value you want to get. value 
points to the variable where the value will be stored. 

void PerformCreate (int menuOrld) ; 

Creates a new control window and associates the VBX control with the 
window. Establishes the control ID, the VBX control name and class, and 
the window caption. Sets Attr.style to the window style of the control, 
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Attr.X and Attr.Y to the upper-left screen coordinates of the control, and 
Attr. W and AttrH to the width and height of the control. 

SetVBXProperty B 00L SetVBXProperty(int proplndex, LONG value, int arraylndex=-l) ; 

Returns nonzero if the specified property value is set, or if unsuccessful. 
propindex is the index number of the property whose value you want to set. 
value is the value to be stored. An optional argument, arraylndex, which is 
-1 by default, specifies the index value in an array of values of the property 
to be set. 



Response table entries 



The TVbxControl class has no response table entries. 

TVbxEventHandler class vbxctl.h 

Derived from TEventHandler, TVbxEventHandler handles events from VBX 
controls. Although you will never need to modify this class, 
TVbxEventHandler needs to be mixed in with your window class so that it 
can receive events from VBX controls. For example, 

class TMyWindow: public TWindow, public TVbxEventHandler 

{ 

// Include class definition here. 

} 

The following diagram illustrates the flow of information between VBX 
controls, parent windows, and response tables. 
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VBX Control 



response table 

When a VBX control fires an event (sends an event message), the following 
sequence of events occurs: 

1. The VBX Control sends a WM_VBXFIREEVENT message to 
TMyWindow. 

2. TMyWindow's TVbxEventHandler finds a WM_VBXFIREEVENT message 
in its response table and calls EvVbxDispatch. 

3. If a child window is present, EvVbxDispatch dispatches the event to the 
child. 

4. If there is an event-handling function in the child window's response 
table, the child window handles the event. 

5. If there is no child window, or the child window doesn't handle the 
event, EvVbxDispatch dispatches the event to TMyWindow's response 
table. 

In other words, when a VBX control sends a WM_VBXFIREEVENT 
message, the parent window's TVbxEventHandler catches this message first, 
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converts it into a form understood by a window's response table, and 
attempts to send the converted message to the child window. If there is no 
child window or if the child window doesn't handle the message, 
TVbxEventHandler sends the converted message to the parent window. 
When the parent window receives the message, it calls the handler function 
that corresponds to the message. 

Two response table macros, EV_VBXEVENTNAME and 
EV_VBXEVENTINDEX, map VBX events to handler functions. Of the two 
macros, EV_VBXEVENTNAME is more commonly used. 
EV_VBXEVENTINDEX is intended for use with code generators, which can 
determine the event index values for a VBX control. Both macros call an 
event handler function and point to the VBXEVENT structure. A typical 
EV_VBXEVENTNAME response table entry might be 

EV_VBXEVENTNAME(IDC_BUTT0N1, "MouseMove", EvMouseMove); 

where IDC_BUTTONl is the event ID, "EvMouseMove" is the event name, 
and EvMouseMove is the handler function. 

The lparam of a WM_VBX FIREEVENT message points to a VBXEVENT 
structure, which holds information about the event and the control that 
generated the event. The VBXEVENT structure contains the following 
members: 



typedef struct VBXEVENT { 


HCTL 


Control ; 


HWND 


Window; 


int 


ID; 


int 


Event Index; 


LPCSTR 


EventName ; 


int 


NumParams ; 


LPVOID 


ParamList; 


} VBXEVENT; 





where 

■ Control is a handle to the VBX control sending the message. 

■ Window is the handle of the VBX control window. 

■ ID is the ID of the VBX control. 

■ Eventlndex is the event index. 

■ EventName is the name of the event. 

■ NumParams holds the number of event arguments. 

■ ParamList is a pointer to a list of pointers to the event's arguments. The 
ParamList data member provides access to the actual arguments of the 
event. 
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To handle VBX events, your program uses an event-handling function. In 
the following example, EvMouseMove is the name of the handler function, 
which passes a pointer to the VBXEVENT event structure. 
VBX_EVENTARGNUM is the macro that takes event, type, and an index 
number as its parameters, event references the VBXEVENT structure, short 
is the event argument type, and and 1 are the index numbers of the 
argument. The argument types and indexes can be found in the 
documentation for the VBX control. 

void EvMouseMove (VBXEVENT FAR* event) 
{ 

short X = VBX_EVENTARGNUM( event, short, 0); 

short Y = VBX_EVENTARGNUM( event, short, 1) ; 
} 

Because VBX controls were originally designed to be used with Visual 
Basic, their event arguments are documented in terms of Basic data types. 
The following table lists the Basic types, their C++ equivalents, and macros. 



Table 1.31 

Basic and C++ VBX 

data types 


Basic 


C++ Macro 


Boolean 

Control 

Double 

Enum 

Integer 

Long 

Single 

String 


short VBX_EVENTARGNUM(ei/enf, short, index) 
HCTL VBX_EVENTARGNUM(evenf, HCTL, index) 
double VBX_EVENTARGNUM(evenf, double, index) 
short VBX_EVENTARGNUM(evenf, short, index) 
short VBX_EVENTARGNUM(evenf, short, index) 
long VBX_EVENTARGNUM(evenf, long, index) 
float VBX_EVENTARGNUM(evenf, float, index) 
HLSTR VBX EVENTARGSTR(evenf, index) 




The following table lists the standard VBX events and corresponding 
arguments that the Borland C++ VBX emulation library supports. 


Table 1.32 
VBX event arguments 


Event 


Arguments 


Click 

DblClick 

DragDrop 

DragOver 

GotFocus 

KeyDown 

KeyPress 

KeyUp 

LostFocus 

MouseDown 

MouseMove 

MouseUp 


None 

None 

Source as Control, X as Integer, Y as Integer 

Source as Control, X as Integer, Y as Integer, State as Integer 

None 

Key as Integer, Shift as Integer 

Key as Integer, Shift as Integer 

Key as Integer, Shift as Integer 

None 

X as Integer, Y as Integer 

X as Integer, Y as Integer, Shift as Integer, Button as Integer 

X as Integer, Y as Integer, Shift as Integer, Button as Integer 
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Table 1.33 
Shift key bit values 



Table 1.34 

Mouse button key 

arguments 



For the DragOver event, the state argument can be one of the following 
values: 

■ 0, where the source control is being dragged within a target's range. 

■ 1, where the source control is being dragged out of a target's range. 

■ 2, where the source control is being moved from one position in the 
target to another. 

For both the DragOver and DragDrop events, the Control argument type 
should be translated to HCTL (a handle to the VBX control) for C++. The X 
and Y values are in pixels, not twips. 

If a standard VBX event has a Shift key argument, the argument has these 
bit values: 



Key 


Bit value 


Shift 

Ctrl 

Alt 


0x1 
0x2 
0x4 (Used in connection with a Menu selection) 


If a standard VBX event has a Button key argument, the argument has these 
bit values: 


Button 


Bit value 


Left 

Right 

Middle 


0x1 
0x2 
0x4 



The following example shows how you might use these Shift key 
arguments. For example, if you want the VBX control to perform some 
action when the mouse is moved and the Shift key is pressed, you could 
write a function such as 

void EvMouseMove (VBXEVENT FAR* event) 
{ 

short X = VBX_EVENTARGNUM( event, short, 0); 

short Y = VBX_EVENTARGNUM( event, short, 1); 

short Shift = VBX_EVENTARGNUM ( event , short, 2); 

short Button = VBX_EVENTARGNUM ( event , short, 3); 

if (shift & 0x2) 

MessageBox ("The control key is pressed."); 
} 

Borland C++ uses pixels to express the X and Y coordinate arguments of 
standard VBX events. This differs from Visual Basic, which expresses 
coordinates in twips (l/20th of a point or 1/1440 of an inch). Custom 
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events are usually expressed in terms of twips. You can use these functions 
to convert between pixels and twips. 



Function 



Meaning 



VBXPix2TwpX() Converts an X argument from pixels to twips 

VBXPix2TwpY() Converts a Y argument from pixels to twips 

VBXTwp2PixX() Converts an X argument from twips to pixels 

VBXTwp2PixY() Converts a Y argument from twips to pixels 



Protected member functions 



EvVbxDispatch LRESULT EvVbxDispatch (WPARAM wp, LPARAM lp) ; 

After TVbxEventHandler receives a WM_VBXFIREEVENT message from the 
parent window, it calls EvVbxDispatch, which sends the message to the 
correct event-handling function and passes a pointer to the VBXEVENT 
structure. 



Response table entries 



Response table entry 



Member function 



EV_MESSAGE(WM_VBXFIREEVENT, EvVbxDispatch) 



EvVbxDispatch 



TView class 



docview.h 



Derived virtually from both TEventHandler and TStreamableBase, TView is 
the interface presented to a document so it can access its client views. 
Views then call the document functions to request input and output 
streams. Views own the streams and are responsible for attaching and 
deleting them. 

Instead of creating an instance of TView , you create a derived class that has 
access to TView's virtual functions. The derived class must have a way of 
knowing the associated window (provided by GetWindow), of describing 
the view (provided by GetViewName), and of displaying a range of data 
(GetSelection). The view must also be able to restore the view later 
(SetSelection) and to display the document title in its window (SetDocTitle). 

TView uses several event handler functions to query views, commit, and 
close views. For example, to query views to find the one with the focus, you 
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would use the vnlsWindozv function, passing a handle to the current 
window. See Chapter 2 for a list of these response functions. 

View classes can take various forms. For example, a view class can be a 
window (through inheritance), can contain a window (an embedded 
object), can reference a window, or can be contained within a window 
object. A view class might not even have a window, as in the case of a voice 
mail or a format converter. Some remote views (for example, those 
displayed by OLE 2.0 or DDE servers) might not have local windows. 

Public data members 



Property enum 



enum { 

PrevProperty 
ViewClass, 
ViewName, 
NextProperty, 



Tag 



Constructor 



Destructor 



These property values, defined for TView, are available in classes derived 
from TView. PrevProperty and NextProperty are delimiters for every 
document's property list. See Chapter 9 in the ObjectWindows Programmer's 
Guide for information about how to use these enumerated property values. 

LPVOID Tag; 

Tag holds a pointer to the application defined data. Typically, you can use 
Tag to install a pointer to your own application's associated data structure. 
TView zeros Tag during construction and doesn't access it again. 

Public constructors and destructor 

TView (TDocument& doc) ; 

Constructs a TView object of the document associated with the view. Sets 
Viewld to NextViewId. Calls TDocumentnAttachView to attach the view to the 
associated document. 

virtual -TView () ; 

Frees a TView object and calls DetachView to detach the view from the 
associated document. 
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Public member functions 



FindProperty 



GetDocument 



GetNextViewld 



GetProperty 



GetViewld 



GetViewMenu 



GetViewName 



GetWindow 



IsOK 



virtual int FindProperty (const char far* name); 

FindProperty gets the property index, given the property name (name). 
Returns if the name isn't found. 

See also: pfxxxx property access constants 

TDocument& GetDocument ( ) ; 

Returns a reference to the view's document. 

inline static unsigned GetNextViewld () ; 
Returns the next view ID to be assigned. 

virtual int GetProperty (int index, void far* dest, int textlen=0); 

Returns the total number of properties where index is the property index, 
dest contains the property data, and textlen is the size of the property array. 
If textlen is 0, property data is returned as binary data; otherwise, property 
data is returned as text data. 

See also: pfxxxx property access constants, TView: :SetProperty 

unsigned GetViewld; 

Returns the unique ID for this view. 

inline TMenuDescr* ViewMenu; 

Returns the menu descriptor for this view. This can be any existing 
TMenuDescr object. If no descriptor exists, ViewMenu is 0. 

inline virtual LPCSTR GetViewName ()=0 ; 

Pure virtual function that returns 0. Override this function in your derived 
class to return the name of the class. 

See also: TEditViewr.StaticName, TEditViewr.GetViewName 

inline virtual TWindow* GetWindow () 

GetWindow returns the TWindow instance associated with the view or if no 
view exists. 

See also: TeditViewr.GetWindow 

inline BOOL IsOK(); 

Returns nonzero if the view is successfully constructed. 

See also: TView::NotOK 
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PropertyCount inline virtual int PropertyCount () ; 

Gets the total number of properties for the TDocument object. Returns 
NextProperty -1. 

See also: pfxxxx property access constants 

PropertyFlags virtual int PropertyFlagsfint index); 

Returns the attributes of a specified property given the index (index) of the 
property whose attributes you want to retrieve. 

See also: pfxxxx property access constants, TView::FindProperty, 
TView ::PropertyName 

PropGrtyName virtual const char* PropertyName(int index); 

Returns the text name of the property given the index value. 

See also: pfxxxx property access constants, TViewr.FindProperty 

SetDocTitle inline virtual BOOL SetDocTitle(LPCSTR docname, int index) 

Stores the document title. 
See also: TWindozv:: SetDocTitle 

SetProperty inline virtual BOOL SetProperty(int index, const void far* src); 

Sets the value of the property, given the index of the property, and src, the 
data type (either binary or text) to which the property must be set. 

See also: pfxxxx property access constants, TV iewr.GetP roper ty 

SetViewMenu inline void SetViewMenu(TMenu* menu; 

Sets the menu descriptor for this view. This can be any existing TMenuDescr 
object. If no descriptor exists, ViezvMenu is 0. 

See also: TView: -.GetViewMenu 

Protected data members 



Doc 



TDocument* Doc- 
Holds the current document. 



Protected member functions 



NotOK 



inline void NotOK ( 
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Sets the view to an invalid state, thus causing IsOK to return 0. 
See also: TViewr.IsOK 



TVSIider class 



slider.h 



Constructor 



Derived from TSlider, TVSIider provides implementation details for vertical 
sliders. See TSlider for an illustration of a vertical slider. 



Public constructors 



TVSIider (TWindow* parent, int id, int X, int Y, int W, int H, 
TResId thumbResId, TModule* module = 0); 



Constructs a vertical slider object. 



Protected member functions 



HitTest 



NotifyParent 



PaintRuler 



PaintSlot 



PointToPos 



int HitTest (TPoint& point); 

Overrides TSHder's virtual function and gets information about where a 
given X, Y location falls on the slider. The return value is in scrollCodes. 

See also: TSlider ::YLitT est 

void NotifyParent (int scrollCode, intpos=0); 

Overrides TSHder's virtual function and sends a WS_VSCROLL message to 
the parent window. 

See also: TSlider: NotifyParent 

void PaintRuler (TDC& dc) ; 

Overrides TSHder's virtual function and paints the vertical ruler. 

See also: TSliderr.PaintRuler 

void PaintSlot (TDC& dc) ; 

Overrides TSHder's virtual function and paints the slot in which the thumb 
slides. 

See also: TSlider: -.PaintSlot 

int PointToPos (TPoint& point); 



Chapter 1, Library reference 



411 



TVSIider class 



Overrides TSlider's virtual function and translates an X,Y point to a position 
in slider units. 

See also: TSlider::PointToPos 

PosToPoint TPoint PosToPoint(int pos); 

Overrides TSlider's virtual function and translates a position in slider units 
to an X,Y point. 

See also: TSliderr.PosToPoint 

TWidthHeight enum layoutco.h 

enum TWidthHeight; 

Used by the TLayoutConstraint struct, TWidthHeight enumerates the values 
that control the width (ImWidth) and height (ImHeight) of the window. 

See also: TLayoutConstraint struct 

TWindow class window.h 

TWindow, derived from TEventHandler and TStreamableBase, provides 
window-specific behavior and encapsulates many of the Windows API 
functions. TWindow functions specify window creation, including 
registration and attributes. 

TWindow is a generic window that can be resized and moved. You can 
construct an instance of TWindow, though normally you'll use TWindow as a 
base for your specialized window classes. In general, to associate and 
disassociate a TWindow object with a window element, you need to follow 
these steps: 

1. Construct an instance of a TWindow. 

1. Call Create or Execute, which creates the interface element and then calls 
SetupWindow, which calls the base SetupWindow for normal processing, 
which in turn involves 

■ Creating the HWindow and any child HWindows. 

■ Calling TransferData to setup the transfer of data between the parent 
and child windows. 

3. To destroy the interface element, choose one of the following actions, 
depending on your application: 
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■ Call Destroy to destroy the interface element unconditionally. 

■ Call Close Window, which calls CanClose to test whether it's OK to 
destroy the interface element. 

4. There are two ways to destroy the interface object: 

■ If the object has been new'd, call Delete. 

m If the object hasn't been new'd, the compiler automatically destructs 
the object. 

TWindow is the base class for many classes, including TFmmeWindow, 
TControl, TDialog, and TMDIChild. The ObjectWindows hierarchy diagram 
shows the classes that are derived from TWindow. 

See Chapter 6 in the ObjectWindows Programmer's Guide for a description of 
window objects and Chapter 2, "Event handlers," for a description of the 
event handlers that respond to Windows messages. 

Public data members 



Attr 



DefaultProc 



HWindow 



Parent 



Scroller 



Status 



TWindowAttr Attr; 

Attr holds a TWindowAttr structure, which contains the window's creation 
attributes. These attributes include the window's style, extended style, 
position, size, menu ID, child window ID, and menu accelerator table ID. 

See also: TWindow: -.TWindow, TWindow "Create, TwindowAttr struct 

WNDPROC DefaultProc; 

Holds the address of the default window procedure. DefWindowProc calls 
DefaultProc to process Windows messages that are not handled by the 
application. 

See also: TWindow -.-.DefWindowProc 

HWND HWindow; 

Holds the handle to the associated MS-Windows window. 

TWindow* parent; 

Points to the interface object that serves as parent window to this interface 
object. 

TScroller* Scroller; 

Points to the interface object that serves as a scroller for this window. 

TStatus Status; 
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Title 



Constructor 



Status is used to signal an error in the initialization of an interface object. 
Setting Status to a nonzero value causes a TXIncompatibility exception to be 
thrown. Classes derived from TWindow do not attempt to associate an 
interface element with an object whose previous initialization has failed. 
Status is included only to provide backward compatibility with previous 
versions of ObjectWindows. 

char far* Title; 

Title points to the window's caption. When there is a valid HWindow, Title 
will yield the same information as ::GetWindowText if you use 
TWindowr.SetCaption to set it. 

See also: TDialog::SetCaption, TDialogr.SetupWindow, 
TWindow: :Get WindowTextTitle, TWindow: :SetCaption 

Public constructors and destructor 

TWindow (HWND hWnd, TModule* module = 0); 

TWindow has two constructors. This constructor constructs a TWindow that 
is used as an alias for a non-ObjectWindows window, and sets wf Alias. 
Unlike the other TWindow constructor, this constructor performs the 
"thunking" and extraction of HWND information instead of waiting until 
the function Create creates the interface element. 

The following paragraphs describe procedures common to both 
constructors, inst specifies the application or DLL module that owns the 
TWindow instance. ObjectWindows needs the correct value of inst to find 
needed resources. If inst is 0, TWindow sets its module according to the 
following rules: 

■ If the window has a parent, the parent's inst is copied. 

■ If the TWindow constructor is invoked from an application, the module is 
set to the application. 

■ If the TWindow constructor is invoked from a DLL that is dynamically 
linked with the ObjectWindows DLL and the currently running 
application is linked the same way, the library is set to the currently 
running application. 

■ If the TWindow constructor is invoked from a DLL that is statically linked 
with the ObjectWindows library or the invoking DLL is dynamically 
linked with ObjectWindows DLL but the currently running application is 
not, no default is used for setting the module. Instead, a TXInvalidModule 
exception is thrown and the object is not created. 

See also: TWindow::Init, TWindowFlag enum 
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Constructor TWindow(TWindow* parent, const char far* title, TModule* module); 

Adds this to the child list of parent, if nonzero, and calls EnableAutoCreate so 
that this will be created and displayed along with parent. Also sets the title 
of the window and initializes the window's creation attributes. 

See the previous constructor for a description of the procedures common to 
both constructors. 

See also: TWindowr.EnableAutoCreate 

Destructor virtual -TWindowO; 

Destroys a still-associated interface element by calling Destroy. Deletes the 
window objects in the child list, and then removes this from the parent 
window's child list. Deletes the Scroller if it is nonzero. Frees the cursor, if 
any exists, and the object instance (thunk). 

Public member functions 

AdjUStWindOWRect inline static void AdjustWindowRect(TRect& rect, DWORD style, BOOL menu); 

Calls the Windows API function ::AdjustWindozvRect, which calculates the 
size of the window rectangle according to the indicated client-rectangle 
size, rect refers to the structure that contains the client rectangle's 
coordinates, style specifies the style of the window, menu is TRUE if the 
window has a menu. See the Windows API online Help for more 
information about window styles. 

See also: :: Adjust WindowRect 

AdjUStWindowRectEx inline static void AdjustWindowRectEx(TRect&, DWORD style, BOOL menu, 

DWORD exStyle); 

Calls the Windows API function :: Adjust WindozvRectEx, which calculates 
the size of a window rectangle that has an extended style. TRect refers to 
the structure that contains the client rectangle's coordinates, style specifies 
the window styles of the window to be adjusted, and menu returns TRUE if 
the window has a menu. exStyle indicates the Windows API extended style 
(for example, WS_EX_TOPMOST) to be used for the window. See the 
Windows API online Help for additional information about extended 
window styles. 

See also: r.AdjusfWindowRectEx, TWindowsAttr struct 

BringWindowToTop inline void BringWindowToTopO ; 
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Calls the Windows API function ::BringWindowToTop, which brings a pop- 
up or child window to the top of the stack of overlapping windows and 
activates it. 

See also: ::BringWindowToTop 

virtual BOOL CanClose (); 

Returns TRUE if the associated interface element can be closed. Calls the 
CanClose member function of each of its child windows. Returns FALSE if 
any of the CanClose calls returns FALSE. 

inline void CheckDIgButton (int buttonld, UINT check); 

Calls the Windows API function r.CheckDlgButton, which places a 
checkmark in (or removes a checkmark from) the button specified in 
buttonld. If check is nonzero, the checkmark is placed next to the button; if 0, 
the checkmark is removed. For buttons having three states, check can be 
(clear), 1 (checked), or 2 (gray). 

See also: r.CheckDlgbutton 

inline void CheckRadioButton(int firstButtonld, int lastButtonld, 

int checkButtonld) ; 

Calls the Windows API function ::CheckRAdioButton, which checks the 
radio button specified by checkButtonld and removes the checkmark from 
the other radio buttons in the group. firstButtonld and lastButtonld specify 
the first and last buttons, respectively, in the group. 

See also: r.CheckRadioButton 
ChildBroadcastMessage ChildBroadcastMessage(UINT msg, WPARAM wParam, LPARAM lParam) ; 

Sends a message to all immediate children using SendMessage. 

See also: TWindow::SendMessage 

ChildWindowFromPoint inline HWND ChildWindowFromPoint (const TPoint&) const; 

Calls the Windows API function ::ChildWindowFromPoint, which determines 
which of the child windows contains the point specified in TPoint. Returns 
a handle to the window that contains the point, or if the point lies outside 
the parent window. 

See also: r.ChildWindowFromPoint, TWindow: :WindowFromPoint 



CheckRadioButton 



ChildWithid TWindow* ChildWithid(int id); 

Returns a pointer to the window in the child window list that has the 
supplied ID. Returns if no child window has the indicated id. 

CleanUpWindoW virtual void CleanupWindowO; 
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ClearFlag 



ClientToScreen 



CloseWindow 



CmExit 



Create 



CreateCaret 



CreateCaret 



CreateChildren 



CleanupWindow gives derived classes a chance to clean up hwnd-related 
resources. Derived classes should call the base class's version of 
CleanupWindow as the last step before returning to the parent class. 

inline void ClearFlag (TWindowFlag mask); 

Clears the TWindow wfXxxx constant flags (for example wf Alias, 
wfTransfer, and so on). 

See also: TWindowFlag enum 

void ClientToScreen (TPoint&) const; 

Converts the client coordinates specified in TPoint to screen coordinates for 
the new window. 

void CloseWindow () ; 

After determining that it's OK to close the window, CloseWindow calls 
Destroy to destroy the hwnd. If this is the main window of the application, 
calls GetApplication()->CanClose. Otherwise, calls this->CanClose to 
determine whether the window can be closed. 

See also: TApplicationr.CanClose, TWindow: :CanClose 

void CmExit () ; 

CmExit is called in response to the selection of a menu item that has an ID 
of CM_EXIT. If this is the main window, CmExit calls CloseWindow. 

virtual BOOL Create () ; 

Creates the windows interface element to be associated with this 
ObjectWindows's interface element. 

inline void CreateCaret (HBITMAP) ; 

Calls the Windows API function : '.CreateCaret, which creates a new caret for 
the system. HBITMAP specifies the bitmapped caret shape. 

See also: -.-.CreateCaret 

inline void CreateCaret (BOOL isGray, int width, int height); 

Calls the Windows API function -.-.CreateCaret to create a new caret for the 
system with the specified shape, bitmap shade, width, and height. If width 
or height is 0, the corresponding system-defined border size is used. 

See also: -.-.CreateCaret 

BOOL CreateChildrenO; 

Creates the child windows in the child list whose auto-create flags (with 
wfAutoCreate mask) are set. 
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See also: TWindow::EnableAutoCreate, TWindow: -.Disable AutoCreate, 
TWindowFlag enum 

DefaultProcessing LRESULT DefaultProcessing ( ) ; 

DefaultProcessing serves as a general-purpose default processing function 
that handles a variety of messages. Before calling DefaultProcessing, 
however, a window completes this sequence of events: 

■ If the window is already created, SubclassWindow is used to install 
StdWndProc in place of the window's current procedure. 

■ If the window hasn't been created, InitWndProc is set up as the window 
proc in the class. Then, when the window first receives a message, 
InitWndProc calls GetModule to get the window's instance thunk (created 
by the constructor by calling CreatelnstanceThunk). InitWndProc then 
switches the message-receiving capability from the window's procedure 
to StdWndProc. 

After this point, StdWndProc responds to incoming messages by calling the 
window's virtual WindowProc to process the messages. ObjectWindows 
uses the special registered message GetWindowPtrMsgld to get the this 
pointer of an HWND. StdWndProc responds by returning the this pointer 
obtained from the thunk. 

If the incoming message is not a command, WindowProc immediately 
searches the window's response table for a matching entry. If the incoming 
message is a command, WindowProc calls EvCommandEnable or EvCommand. 
EvCommandEnable and EvCommand begin searching for a matching entry in 
the focus window's response table. If an entry is found, the corresponding 
function is dispatched; otherwise ObjectWindows calls DefaultProcessing to 
finish the recursive walk back up the parent chain, searching for a match 
until the receiving window (the window that initially received the 
message) is reached. At this point, one of the following actions occurs: 

■ If there is still no match and this is the MainWindow of the application, 
the window searches the application's response table. 

■ If there are no matches and this is a command, DefWindowProc is called. 

■ If this is a CommandEnable message, no further action is taken. 

■ If this is not a command, and if a response table entry exists for the 
window, WindowProc dispatches the corresponding EvXxxx function to 
handle the message. 

■ If this is the application's MainWindow, and the message is designed for 
the application, the message is forwarded to the application. 

■ For any other cases, the window calls DefWindowProc. 
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To perform a DLL test for a non-ObjectWindows application, you might 
process the following messages. 

LRESULT FAR PASCAL _export 

WndProc (HWND hWnd, UINT message, WPARAM, wParam, LPARAM lParam) 
{ 

switch (message) { 
case WM_DESTROY: 

PostQuitMessage (0); 
break; 
case WM_COMMAND: 

//Insert processing statements here.// 
} else 

return DefwindowProc (hWnd, message, wParam, lParam) ; 
break; 
default: 

return DefwindowProc (hWnd, message, wParam, lParam) ; 
} 

See also: TWindozvr.DefWindowProc 

The following diagram illustrates this sequence of message-processing 
events: 
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DefWindOWProc virtual LRESULT DefWindowProc(UINT msg, WPARAM wParam, LPARAM lParam) ; 

Calls DefaultProc, the subclassed window procedure, for default Windows 
processing and passes the incoming Windows message. You usually don't 
need to call this function directly. Classes such as TMDIFrame and 
TMDIChild's DefWindowProc override this function to perform specialized 
default processing. 

See also: TWindow::DefaultProc, TWindozv::WindowProc, 
TMDIFramer.DefWindowProc 

Destroy virtual void Destroy (int retVal = 0); 

First, Destroy calls EnableAutoCreate for each window in the child list to 
ensure that windows in the child list will be re-created if this is re-created. 
Then, it destroys the associated interface element. 

If a derived window class expects to be destructed directly, it should call 
Destroy as the first step in its destruction so that any virtual functions and 
event handlers can be called during the destroy sequence. 

See also: TWindowr.EvDestroy, T Window "Enable AutoCreate 

DestroyCaret inline static void DestroyCaret () ; 

Calls the Windows API function DestroyCaret, which first checks the 
ownership of the caret. If a window in the current task owns the caret, 
DestroyCaret destroys the caret and removes it from the screen. 

See also: TWindow::CreateCaret, -.-.DestroyCaret 

DisableAutoCreate inline void DisableAutoCreateO ; 

Disables the feature that allows an associated child window interface 
element to be created and displayed along with its parent window. Call 
DisableAutoCreate for pop-up windows and controls if you want to create 
and display them at a time later than their parent windows. 

See also: T Window: -.EnableAutoCreate 



DisableTransfer 



DragAcceptFiles 



inline void DisableTransfer () ; 

Disables (for the interface object) the transfer mechanism, which allows 
state data to be transferred to and from a transfer buffer. 

See also: TWindowFlag enum 

void DragAcceptFiles (BOOL accept); 

If a window can process dropped files, DragAcceptFiles calls the Windows 
API function DragAcceptFiles to set accept. 
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DrawMenuBar 



EnableAutoCreate 



EnableTransfer 



EnumProps 



EvChildlnvalid 



EvCommand 



EvCommandEnable 



See also: ::DragAcceptFiles 

inline void DrawMenuBar () ; 

Calls the Windows API function DrawMenuBar to redraw the menu bar. 
This function should be called to redraw the menu if the menu is changed 
after the window is created. 

See also: -.-.DrawMenuBar 

inline void EnableAutoCreate () ; 

Ensures that an associated child-window interface element is created and 
displayed along with its parent window. By default, this feature is enabled 
for windows and controls, but disabled for dialog boxes. 

See also: TWindow /Disable AutoCreate 

inline void EnableTransfer () ; 

Enables the transfer mechanism, which allows state data to be transferred 
between the window and a transfer buffer. 

See also: TWindow/DisableTransfer 

inline int EnumProps (PROPENUMPROC proc) ; 

Calls the Windows API function /EnumProps to enumerate the items in the 
property list of the specified window. 

See also: /EnumProps 

void EvChildlnvalid (HWND) ; 

Responds to a WM_CHILDINVALID message posted by a child edit 
control. Indicates that the contents of the child window are invalid. 

virtual LRESULT EvCommand (UINT id, HWND hWndCtl, UINT notifyCode); 

WindowProc calls EvCommand to handle WM_COMMAND messages, id is 
the identifier of the menu item or control. hWndCtl holds a value that 
represents the control sending the message. If the message is not from a 
control, it is 0. notifyCode holds a value that represents the control's 
notification message. If the message is from an accelerator, notifyCode is 1; if 
the message is from a menu, notifyCode is 0. 

See also: TWindow/DefaultProcessing 

virtual void EvCommand (TCommandEnabler &) ; 

Called by WindowProc to handle WM_COMMAND_ENABLE messages, 
EvCommand calls the CmXxxx command-handling function or calls 
DefaultProcessing to handle the incoming message. 
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See also: TWindow ::DefaultProcessing 

EvSysCommand void EvSysCommand (UINT cmdType, TPoint &) ; 

Responds to a user-selected command from the System menu or when the 
user selects the maximize or minimize box. Applications that modify the 
system menu must process EvSysCommand messages. Any EvSysCommand 
messages not handled by the application must be passed to DefWindowProc. 
The parameter cmdType can be one of the following system commands: 



Constant 



Meaning 



FirstThat 



SC_CLOSE 

SCJHOTKEY 

SC_HSCROLL 

SC_KEYMENU 

SC_MAXIMIZE(orSC_ZOOM) 

SC_MINIMIZE (or SCJCON) 

SC_MOUSEMENU 

SC.NEXTWINDOW 

SC_PREVWINDOW 

SC_SCREENSAVE 

SC_SIZE 

SC_TASKLIST 

SC VSCROLL 



Close the window. 

Activate the specified window. 

Scroll horizontally. 

Retrieve a menu through a keystroke. 

Maximize the window. 

Minimize the window. 

Retrieve a menu through a mouse click. 

Move to the next window. 

Move to the previous window. 

Execute the specified screen saver. 

Size the window 

Activate the Windows Task Manager. 

Scroll vertically. 



In the following example, EvSysCommand either processes system messages 
or calls DefaultProcessing: 

void MyWindow: : EvSysCommand (UINT cmdType, TPoint&) 
{ 
switch (cmdType & OxFFFO) { 
case SC_MOUSEMENU: 
case SC_KEYMENU: 

break; 
default: 
DefaultProcessing () ; 



} 



See also: T Window "DefaultProcessing 

TWindow* FirstThat (TCondFunc test, void* paramList = 0); 

There are two FirstThat functions, both of which pass a pointer to an 
iterator function. This FirstThat points to a nonmember function as its first 
parameter; the other FirstThat (see the following entry) points to a member 
function instead. 
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FirstThat 



FlashWindow 



ForEach 



Both FirstThat functions iterate over the child list, calling a Boolean test 
function and passing each child window in turn as an argument (along 
with paramList). If a test call returns TRUE, the iteration is stopped and 
FirstThat returns the child window object that was supplied to test. 
Otherwise, FirstThat returns 0. 

In the following example, GetFirstChecked calls FirstThat to obtain a pointer 
(p) to the first check box in the child list that is checked: 

BOOL I sThisBoxChecked (TWindow* p, void*) { 

return ( (TCheckBox*)p) ->GetCheck() == BF_CHECKED; 
} 

TCheckBox* TMyWindow. : GetFirstChecked () { 

return FirstThat (IsThisBoxChecked) ; 
} 

See also: TCondFunc type 

TWindow* FirstThat (TCondMemFunc test, void* paramList = 0); 

Refer to the previous description of FirstThat. The difference between the 
two FirstThat functions is that the previous FirstThat takes a nonmember 
function as a parameter and this FirstThat takes a member function as a 
parameter. 

See also: TCondMemFunc type 

inline BOOL FlashWindow (BOOL invert); 

Calls the Windows API function FlashWindow to change the window from 
active to inactive or vice versa. If invert is nonzero, the window is flashed. If 
invert is 0, the window is returned to its original state — either active or 
inactive. 

See also: : -.FlashWindow 

void ForEach (TActionFunc action, void* paramList = 0); 

There are two ForEach functions. This ForEach takes a nonmember function 
as its first parameter; the other ForEach (see the following entry) takes a 
member function instead. Both versions of ForEach iterate over the child 
list, calling a nonmember function supplied as the action to be performed 
and passing each child window in turn as the argument (along with 
paramList). 

In the following example, CheckAUBoxes calls ForEach, checking all the 
check boxes in the child list: 

void CheckTheBox (TWindow* p, void*) { 
( (TCheckBox* ) p) ->Check ( ) ; 
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ForEach 



ForwardMessage 



ForwardMessage 



void CheckAllBoxesO { 

ForEach (CheckTheBox) ; 
} 

See also: TActionFunc type 

void ForEach (TActionMemFunc action, void* paramList = 0); 

Refer to the previous ForEach description. The difference between the two 
ForEach members is that the first ForEach takes a nonmember function as a 
parameter and this ForEach takes a member function as a parameter. 

See also: TActionMemFunc type 

inline LRESULT ForwardMessage (BOOL send - TRUE) 

Forwards the window's current message. Calls the Windows API function 
r.SendMessage if send is TRUE; otherwise calls ::PostMessage. 

See also: TWindowr.PostMessage 

LRESULT ForwardMessage (HWND hWnd, BOOL send = TRUE); 

Forwards the window's current message to another HWND. Calls the 
Windows API function r.SendMessage if send is TRUE; otherwise calls 

::PostMessage. 

See also: TWindowr.PostMessage 

inline static HWND GetActiveWindowO ; 

Calls the Windows API function GetActiveWindow to retrieve the handle of 
the active window. Returns if no window is associated with the calling 
thread. 

See also: : -.GetActiveWindow 

GetApplication TApplication* GetApplicationO ; 

Gets a pointer to the TApplication object associated with this. 

GetCaretBlinkTime inline static UINT GetCaretBlinkTimeO ; 

Calls the Windows API function GetCaretBlinkTime to retrieve the caret 
blink rate in milliseconds. 

See also: TWindow rSetCaretBlinkTime 

GetCaretPoS inline static void GetCaretPos(TPoint& point); 

Calls the Windows API function GetCaretPos to get the position of the caret 
in the coordinates of the client window, point refers to the structure that 
receives the client coordinates of the caret. 



GetActiveWindow 



Chapter 1, Library reference 



425 



TWindow class 



GetChildren 



GetClassLong 



GetClassWord 



GetClientRect 



GetClientRect 



GetCursorPos 



GetDesktopWindow 



See also: TWindowr.SetCaretPos 

void GetChildren (ipstream &is); 

Reads child windows from the supplied stream into a child list. GetChildren 
should be called only during a read operation to read child windows that 
were written to the stream by PutChildren. 

This member function assumes that the child list is currently empty. 

inline long GetClassLong (int index) const; 

Calls the Windows API function GetClassLong to retrieve the long value 
from the Windows API WNDCLASS structure. Depending on the value of 
index, GetClassLong retrieves a handle to the background brush, cursor, 
icon, module, menu, window function, and so on. 

See also: ::GetClassLong, Twindow::SetClassLong 

inline WORD GetClassWord (int index) const; 

Calls the Windows API function GetClassWord to get the word value from 
the Windows API WNDCLASS structure. Depending on the value of index, 
GetClassLong can retrieve class, window, or style information. 

See also: ::GetClassWord, TWindow ::SetClass Word 

inline TRect GetClientRect () const; 

Calls the Windows API function GetClientRect to get the coordinates of the 
window's client area. 

See also: ::GetClientRect 

inline void GetClientRect (TRect &) const; 

Calls the Windows API function GetClientRect to get the coordinates of the 
window's client area and to copy them into the object referred to by TRect. 

See also: -.-.GetClientRect 

inline static void GetCursorPos (TPoint &pos) ; 

Calls the Windows API function GetCursorPos to retrieve the cursor's 
current position (in client window screen coordinates) and copy them into 
the structure pointed to by TPoint. 

See also: -.-.GetCursorPos 

inline static HWND GetDesktopWindow; 

Calls the Windows API function GetDesktopWindow and returns a handle to 
the desktop window. 
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GetDlgltem 



GetDlgltemlnt 



GetDlgltemText 



GetFirstChild 



Getld 



GetModule 
GetLastActivePopup 
GetLastChild 
GetMenu 



HWND GetDlgltem (int childld) const; 

Calls the Windows API function GetDlgltem to retrieve the handle of a 
control specified by childld. 

See also: TWindow::GetDlgItem 

UINT GetDlgltemlnt (int childld, BOOL translated = 0,BOOL isSigned = TRUE) 
const; 

Calls the Windows API function GetDlgltemlnt to retrieve the text of a 
control specified by childld. translated points to the variable that receives the 
translated value. isSigned indicates that the retrieved value is signed (the 
default). 

See also: TWindow: -.GetDlgltemlnt 

UINT GetDlgltemText (int childld, char far* text, int max) const; 

Calls the Windows API function GetDlgltemText to retrieve the text of a 
control specified by childld. text points to the text buffer to receive the text. 
max specifies the maximum length of the caption, which is truncated if it 
exceeds this length. 

See also: TWindowr.SetDlgltemText, -.-.GetDlgltemText 

inline TWindow* GetFirstChild () 

Returns a pointer to the first child window in the interface object's child list. 

See also: TWindowAttr struc 

int Get Id (); 

Returns Attr.Id, the ID used to find the window in a specified parent's child 
list. 

See also: TWindowAttr struct 

inline TModule* GetModule () const; 

Returns a pointer to the module object. 

HWND GetLastActivePopup () const; 

Returns the last active popup window in the list. 

TWindow* GetLastChild (); 

Returns a pointer to the last child window in the interface object's child list. 

inline HMENU GetMenu () const; 
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Calls the Windows API function GetMenu to get the handle to the menu of 
the indicated window. If the window has no menu, the return value is 0. 



See also: TWindow: -.SetMenu 

GetNextDlgGroupltem 'inline HWND GetNextDlgGroupItem(HWND hWndCtrl, BOOL previous 

const; 



FALSE) 



Calls the Windows API function GetNextDlgGroupltem to return either the 
next or the previous control in the dialog box. hWndCtrl identifies the 
control in the dialog box where the search begins. If previous is 0, 
GetNextDlgGroupltem searches for the next control; if nonzero, it searches 
for the previous control. 

See also: "GetNextDlgGroupltem 

GetNextDlgTabltem inline HWND GetNextDlgTabItem(HWND HWndCtrl, BOOL previous = FALSE) const; 

Calls the Windows API function GetNextDlgTabltem to return the handle of 
the first control that lets the user press the TAB key to move to the next 
control (that is, the first control with the WS_TABSTOP style associated 
with it). hWndCtrl identifies the control in the dialog box where the search 
begins. If previous is 0, GetNextDlgGroupltem searches for the next control; if 
nonzero, it searches for the previous control. 



GetNextWindow 



GetWindowPtr 



GetParent 



GetProp 



See also: -.-.GetNextDlgTabltem 

inline HWND GetNextWindow (UINT dirFlag) const; 

Calls the Windows API function GetNextWindow to find the handle 
associated with either the next or previous window in the window 
manager's list. dirFlag specifies the direction of the search. Under the 
WIN32 API, GetNextWindow returns either the next or the previous 
window's handle. If the application is not running under Win32, 
GetNextWindow returns the next window's handle. 

See also: :: GetNextWindow 

void GetWindowPtr (HWND hWnd) ; 

Given the handle to a window (hWnd), GetWindowPtr returns the TWindow 
pointer associated with the window. 

inline HWND GetParent () const; 

Calls the Windows API function GetParent to retrieve the handle of the 
parent window. If none exists, returns 0. 

See also: TWindow r.SetParent 

inline HANDLE GetProp (WORD atom) const; 
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Calls the Windows API function GetProp to return a handle to the property 
list of the specified window, atom contains a value that identifies the 
character string whose handle is to be retrieved. 

See also: TWindowr.SetProp, r.GetProp 

GetProp inline HANDLE GetProp (const char far* string) const; 

Calls the Windows API function GetProp return a handle to the property list 
of the specified window. Unlike the previous GetProp function, string points 
to the string whose handle is to be retrieved. 

See also: TWindozv::SetProp, r.GetProp 

GetScrollPoS inline int GetScrollPos(int bar) const; 

Calls the Windows API function GetScrollPos to return the thumb position 
in the scroll bar. bar identifies the position (horizontal, vertical, or scroll bar 
control) to return; it can be one of the Windows API SB_xxxx constants. 

See also: TWindozv::GetScrollPos, ::GetScrollPos 

GetScrollRange inline void GetScrollRange(int bar, int kminPos, int &maxPos) const.; 

Calls the Windows API function GetScrollRange to return the thumb 
position in the scroll bar. bar identifies the position (horizontal, vertical, or 
scroll bar control) to return; it can be one of the Windows API SB_xxxx 
constants. minPos and maxPos specify the lower and upper range, 
respectively, of the scroll bar positions. 

See also: TWindow::SetScrollRange, r.GetScrollRange 

GetSysModalWindoW inline static HWND GetSysModalWindowO; 

Retrieves the handle of the system-modal window. 
See also: TWindowr.SetSysModalWindow 

inline HMENU GetSystemMenu(BOOL revert = FALSE) const; 

Calls the Windows API function GetSystemMenu and returns a handle to 
the system menu so that an application can access the system menu. 

See also: ::GetSystemMenu 

inline HWND GetTopWindow ( ) const; 

Calls the Windows API function GetTopWindow, which returns a handle to 
the top window currently owned by this parent window. If no children 
exist, GetTopWindow returns 0. 

See also: : -.GetTopWindow 

inline BOOL GetUpdateRect (TRect &, BOOL erase = TRUE) const; 




GetSystemMenu 



GetTopWindow 



GetUpdateRect 
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Calls the Windows API function GetUpdateRect to retrieve the screen 
coordinates of the rectangle that encloses the updated region of the 
specified window, erase specifies whether GetUpdateRect should erase the 
background of the updated region. 

See also: -.-.GetUpdateRect, TWindowr.RedrawWindow 

GetUpdateRgn inline BOOL GetUpdateRgn(TRegion &, BOOL erase = TRUE) const; 

Calls the Windows API function GetUpdateRgn to copy a window's update 
region into a region specified by region, erase specifies whether 
GetUpdateRgn should erase the background of the updated region. 
GetUpdateRgn returns a value indicating the type of region such as 
COMPLEXREGION, ERROR, NULLREGION, or SIMPLEREGION. See the 
Windows API online Help for a description of these values. 

See also: TWindow: -.Redraw Window, : -.GetUpdateRgn 

GetWindowLong inline long GetWindowLong ( int index) const; 

Returns information (such as style attributes) about the indicated window 
from the WNDCLASS structure. 

See also: TWindow: -.GetClassLong, "GetWindowLong 

GetWindOWPIacement inline BOOL GetWindowPlacement(WINDOWPLACEMENT* place) const; 

Calls the Windows API function GetWindowPlacement to retrieve display 
and placement information (normal, minimized, and maximized positions) 
about the window and stores that information in place. 

See also: TWindow:: Set WindowPlacement, TWindow::Show 

GetWindowRect inline void GetWindowRect(TRect &) const; 

Gets the screen coordinates of the window's rectangle and copies them into 
the area pointed to by TRect. 

See also: T Window r.GetClientRect, : -.GetWindowRect 

GetWindOWTask inline HANDLE GetWindowTaskO const; 

Calls the Windows API function GetWindowThreadProcessId to return the 
thread ID of the thread that created the specified window. 

GetWindOWTask inline HTASK GetWindowTaskO const; 

Calls the Windows API function GetWindowTask to return a handle to the 
task that created the specified window. 

GetWindOWText inline int GetWindowText (char far* string, int maxCount) const; 
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Calls the Windows API function GetWindowText which copies the window's 
title into a buffer pointed to by string. maxCount indicates the number of 
characters to copy into the buffer. A string of characters longer than 
maxCount is truncated. GetWindowText returns the length of the string or 
if no title exists. 

See also: TWindow: :SetWindowText, TWindow: :GetWindowTextTitle, 
r.Get WindowText, TWindow ::SetCaption 

GetWindowTextLength inline int GetWindowTextLength ( ) const; 

Calls the Windows API function GetWindowTextLength, which returns the 
length of the specified window's title. 



GetWindowTextTitle 



GetWindowWbrd 



HandleMessage 



HideCaret 



See also: TWindow.-.SetWindowText, -.-.GetWindowTextLength 

void GetWindowTextTitle ( ) ; 

Updates the TWindow title data member (Title) from the current window's 
caption. GetWindowTextTitle is used to keep Title synchronized with the 
actual window state when there is a possibility that the state might have 
changed. 

See also: TWindow::SetCaption, TWindow ::Title 

inline WORD GetWindowWord ( int index) const; 

Calls the Windows API function GetWindowWord, which retrieves 
information about the window depending on the value stored in index. 
GetWindowWord returns values that indicate the handle of the module that 
owns the window (GWWJHMODULE), the handle of the parent window 
(GWW_HWNDPARENT), or the parent window 
(GWW_HWNDPARENT). 

See also: TWindow ::GetWindowLong, TWindow:: Set Window Word, 
TWindow r.SetParent, ::GetWindowWord 

LRESULT HandleMessage (UINT msg, WPARAM wParam = 0, LPARAM lParam = 0); 

Handles message sent to a window. HandleMessage can be called directly to 
handle Windows messages without going through SendMessage. 

See also: TWindow: -.SendMessage 

inline void HideCaret ( ) ; 

Calls the Windows API function HideCaret, which removes the caret from 
the specified display screen. The caret is hidden only if the current task's 
window owns the caret. 

See also: TWindow r.CreateCaret, -.-.HideCaret, TWindow.-.ShowCaret 
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HiliteMenultem 



HoldFocusHwnd 



Invalidate 



InvalidateRect 



InvalidateRgn 



IsChild 

IsDIgButtonCheeked 

IsFlagSet 



inline BOOL HiliteMenultem (HMENU, UINT idltem, UINT hilite); 

Calls the Windows API function HiliteMenultem, which either highlights or 
removes highlighting from a top-level item in the menu, idltem indicates 
the menu item to be processed, hilite (which contains a value that indicates 
if the idltem is to be highlighted or is to have the highlight removed) can be 
one or more of the MF_xxxx constants (for example, MF_HILITE or 
MFJBYPOSITION). 

See also: TWindow::, ::HiliteMenuItem 

virtual BOOL HoldFocusHWnd(HWND hWndLose, HWND hWndGain) ; 

Responds to a request by a child window to hold its HWND when it is 
losing focus. Stores the child's HWND in HwndRestoreFocus. 

See also: TFrameWindow::HoldFocusHwnd 

inline void Invalidate (BOOL erase = TRUE);; 

Calls the Windows API function InvalidateRect to invalidate (mark for 
painting) the entire client area. By default, the background of the client area 
is marked for erasing. 

See also: TWindow::Validate, r.InvalidateRect 

inline void InvalidateRect (const TRectk, BOOL erase = TRUE);; 

Calls the Windows API function InvalidateRect to invalidate a specified 
client area. By default, the background of the client area to be invalidated is 
marked for erasing. 

See also: TWindow ::ValidateRect, r.InvalidateRect 

inline void InvalidateRgn (HRGN hRgn, BOOL erase = TRUE); 

Calls the Windows API function InvalidateRgn to invalidate a client area 
within a region specified by hRgn when the application receives a 
WM_PAINT message. By default, the background within the region is 
marked for erasing. 

See also: TWindow r.ValidateRgn, -.-.InvalidateRgn 

inline BOOL IsChild (HWND) const; 

Is TRUE if the window is a child of this window. 

inline UINT IsDIgButtonCheeked (int buttonld) const; 

Is TRUE if the child button specified in buttonld is checked. 

inline BOOL IsFlagSet (TWindowFlag mask); 
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Returns the state of the bit flag in Attr.Flags whose mask is supplied. Returns 
TRUE if the bit flag is set, and FALSE if not set. 

See also: TWindow Attr struc 
Islconic inline BOOL Islconicl) const; 

Is TRUE if window is iconic or minimized. 
IsWindowVl'sible inline BOOL IsWindowVisibleO const; 

Is TRUE if the window is visible. By default, T Window's constructor sets the 
window style attribute (WS_VISIBLE) so that the window is visible. 

IsZoomed inline BOOL IsZoomedO const; 

Is TRUE if window is zoomed or maximized. 

KillTimer inline BOOL KillTimer(UINT timerld) ; 

Calls the Windows API function KillTimer which gets rid of the timer and 
removes any WM_TIMER messages from the message queue, timerld 
contains the ID number of the timer event to be killed. 

See also: TWindow ::SetTimer, ::KillTimer 

LockWindowUpdate inline BOOL LockWindowUpdate ( ) ; 

Calls the Windows API function LockWindowUpdate to prevent any drawing 
in the specified window. Returns if the window is locked. 

See also: -.-.LockWindowUpdate 

MapWindOWPointS inline void MapWindowPoints(HWND hWndTo, TPoint* points, int count) const; 

Calls the Windows API function MapWindowPoints to map a set of points in 
one window to a relative set of points in another window. HWndTo specifies 
the window to which the points are converted, points points to the array 
containing the points. If hWndTo is 0, the points are converted to screen 
coordinates, count specifies the number of points structures in the array. 

See also: -.-.MapWindowPoints 

Message Box j_ n ^ MessageBox( const char far* text, const char far* caption = 0, 

UINT type = MB_0K); 

Creates and displays a message box that contains a message {text), a title 
{caption), and icons or push buttons {type). If caption is 0, the default title is 
displayed. Although type is set to one push button by default, it can 
contain a combination of the WIN API MB_xxxx constants. This function 
returns one of the following WIN API constants: ID ABORT, IDCANCEL, 
IDIGNORE, IDNO, IDOK, IDRETRY, IDYES. 
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MoveWindow 



MoveWindow 



Next 



NumChildren 



OpenClipboard 



Paint 



PostMessage 



See also: r.MessageBox 

inline void MoveWindow ( int x, int y, int w, int h, BOOL repaint = FALSE); 

Calls the Windows API function MoveWindow to reposition the specified 
window, x and y specify the new upper left coordinates of the window; w 
and h specify the new width and height, respectively. If repaint is FALSE, 
the window is not repainted after it is moved. 

See also: -.•.MoveWindow 

inline void MoveWindow (const TRect &, BOOL repaint = FALSE); 

Calls the Windows API function MoveWindow, passing the left and top 
coordinates and the width and height of the new screen rectangle. 

See also: -.-.MoveWindow 

inline TWindow* Next(); 

Returns a pointer to the next window in the window's sibling list. 

See also: TWindow -.-.Previous 

unsigned NumChildren () ; 

Returns the number of ObjectWindows child windows. 

inline TClipboard &OpenClipboard() ; 

Calls the TClipboard function GetClipboard to get the global Clipboard object. 
Then, OpenClipboard opens the Clipboard object before returning it. 

See also: TClipboard::GetClipboard 

virtual void Paint (TDC&, BOOL erase, TRect&); 

Called by base classes when responding to a WM_PAINT message, Paint 
serves as a placeholder for derived types that define Paint member 
functions. Paint is called by EvPaint and requested automatically by 
Windows to redisplay the window's contents. TDC is the paint display 
context supplied to text and graphics output functions. The supplied 
reference to the Trect structure is the bounding rectangle of the area that 
requires painting, erase indicates whether the background needs erasing. 



inline BOOL PostMessage (UINT msg, WPARAM wParam = 

const ; 



LPARAM lParam= 



Wrapper function for the Window's API function by the same name, 
PostMessaage posts a message (msg) in a window's message queue. It returns 
without waiting for the corresponding window to process the message. 

See also: TWindow: -.ForwardMessage, -.-.PostMessage 
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PerformCreate 



PreProcessMsg 



Previous 



ReceiveMessage 



RedrawWindow 



Register 



virtual void PerformCreate (int menuOrld) ; 

Create an MS_Windows interface element to be associated with an 
ObjectWindows window. 

virtual BOOL PreProcessMsg (MSG& msg); 

PreProcessMsg allows preprocessing of window messages and keyboard 
messages. If you override this method in a derived class, be sure to call 
PreProcessMsg because it handles the translation of accelerator keys. When 
nonzero is returned, message processing stops. 

See also: TApplicationr.ProcessAppMsg 

TWindow* Previous ( ) ; 

Returns a pointer to the previous window in the parent window's child list. 

See also: TWindow ::Next 

LRESULT ReceiveMessage (UINT msg, WPARAM wParam = 0, LPARAM lParam = 0); 

Called from StdWndProc, ReceiveMessage is the first member function called 
when a message is received. It calls HandleMessage from within the try block 
of the exception-handling code. In this way, exceptions can be caught and 
suspended before control is returned to exception-unsafe Window code. 

See also: TWindow: -.HandleMessage 



inline BOOL RedrawWindow (TRect* update, HRGN hUpdateRgn, 

UINT redrawFlags = RDW_INVALIDATE 
I RDW ERASE) ; 



RDW UPDATENOW 



RegisterHotKey 



Calls the Windows API function RedrawWindow to redraw the rectangle at 
the address specified by hUpdateRgn. redrawFlags can be a combination of 
the Windows API RDW_xxxx constants. See the Windows API online Help 
for a list of these values. 

See also: TWindow r.GetUpdateRect 

virtual BOOL Register!); 

Registers the Windows registration class of this, if this is not already 
registered. Calls GetClassName and GetWindowClass to retrieve the 
Windows registration class name and attributes of this. Register returns 
TRUE if this is registered. 

See also: TWindowr.GetClassName, TWindow:: GetWindowClass 

inline BOOL RegisterHotKey (int idHotKey, UINT modifiers, UINT virtKey) ; 
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RemoveProp 



RemoveProp 



ScreenToClient 



Scroll Window 



ScrollWindowEx 



Calls the Windows API function RegisterHotKey to register a hotkey ID with 
the current application, modifiers can be a combination of keys that must be 
pressed to activate the specified hotkey, for example, HOTKEYF_SHIFT, 
HOTKEYF_CONTROL, and HOTKEYF_ALT. 

See also: : -.RegisterHotKey, TWindow <::UnRegisterHotKey 

HANDLE RemoveProp (WORD atom) const; 

Calls the Windows API function RemoveProp to remove the property 
specified by atom from the application's property list. 

See also: TWindowr.GetProp 

HANDLE RemoveProp (const char far* str) const; 

Calls the Windows API function RemoveProp to remove the property 
specified by str from the application's property list. 

See also: TWindowr.GetProp 

inline void ScreenToClient (TPoint& point) const; 

Calls the Windows API function ScreenToClient to use the screen 
coordinates specified in point to calculate client window's coordinates and 
then place the new coordinates into point. 

See also: :: ScreenToClient 

inline void ScrollWindow(int dx, int dy, const TRect* scroll = 0, 

const TRect far *clip = 0); 

Calls the Windows API function ScrollWindow to scroll a window in the 
vertical (dx) and horizontal (dy) directions. TRect indicates the area to be 
scrolled. If 0, the entire client area is scrolled, clip specifies the clipping 
rectangle to be scrolled. Only the area within clip is scrolled. If clip is 0, the 
entire window is scrolled. 

See also: TWindow:: ScrollWindowEx, y.ScrollWindow 

inline void ScrollWindowEx (int dx, int dy, const TRect *scroll = 0, 

const TRect far *clip = 0, HRGN hUpdateRgn = 0, 
TRect far *update = 0, UINT flags = 0); 

Calls the Windows API function ScrollWindowEx to scroll a window in the 
vertical (dx) and horizontal (dy) directions. TRect indicates the area to be 
scrolled. If 0, the entire client area is scrolled, clip specifies the clipping 
rectangle to be scrolled. Only the area within clip is scrolled. If clip is 0, the 
entire window is scrolled, update indicates the region that will receive the 
boundaries of the area that becomes invalidated as a result of scrolling. 
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SendDlgltemMessage 



Send Message 



SendNotification 



SetActiveWindow 



SetBkgndColor 



flags, which determines how the window's children are scrolled, can be one 
of the Windows API SWjxxxx constants; for example, 
SW_SCROLLCHILDREN. See the Windows API online Help for a list of 
these constants. 

See also: TWindowr.ScrollWindow, r.ScrollWindowEx, TWindow:: Show 

inline LRESULT SendDlgltemMessage (int childld, UINT msg, 

WPARAM wParam = 0, LPARAM lParam = 0) 
const; 

Calls the Windows API function SendDlgltemMessage to send a message 
(msg) to the control specified in childld. 

See also: TWindow:: SendMessage, :: SendDlgltemMessage 

inline LRESULT SendMessage (UINT msg, WPARAM wParam = 0, LPARAM lParam = 0) 

const; 

Wrapper function for the Window's API function by the same name, 
SendMessage sends a message (msg) to a specified window or windows. 
After it calls the window procedure, it waits until the window procedure 
has processed the message before returning. 

See also: TWindow r.ChildBroadcastMessage, TWindow r.HandleMessage, 
TWindow: .SendDlgltemMessage, -.-.SendMessage 

inline void SendNotification (int id, int notifyCode, HWND hCtl, 

UINT msg = WM_COMMAND) ; 

Repacks a command message (msg) so that a child window (hCtl) can send 
a message to its parent regardless of whether this is a WIN16 or WIN32 
application. 

inline HWND SetActiveWindow () ; 

Calls the Windows API function SetActiveWindow to activate a top-level 
window. Returns a handle to the previously active window. 

See also: TWindow::GetActiveWindow, -.-.SetActiveWindow 

inline void SetBkgndColor (DWORD color); 

Sets the background color (color) for the window. You can also get the 
current color of an element displayed on the screen. For example, 

layout -> SetBkgndColor (GetSysColor (COLOR JVPPWORKSPACE)); 

uses one of the Windows COLOR values (in this case, the color of multiple 
document interface applications (MDI). See the online Help file for a list of 
these display values. 
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SetCaption 



SetCaretBlinkTime 



SetCaretPos 



SetCaretPos 



SetClassLong 



SetClassWord 



SetCursor 



See also: ::GetSysColor 

void SetCaption (const char far* title); 

Copies title to an allocated string pointed to by Title. Sets the caption of the 
interface element to title. Deletes any previous title. 

See also: TWindowr.GetWindowTitle, TWindow: -.Title 

inline static void SetCaretBlinkTime (WORD milliSecs) ; 

Calls the Windows API function SetCaretBlinkTime to set the caret blink rate 
in milliseconds. 

See also: TWindow: :GetCaretBlinkTime, :: SetCaretBlinkTime 

inline static void SetCaretPos (int x, int y) ; 

Calls the Windows API function SetCaretPos to set the position of the caret 
in the coordinates of the client window, x and y indicate the screen 
coordinates of the structure that receives the client coordinates of the caret. 

See also: TWindow: -.GetCaretPos, TWindow r.ShowCaret 

inline static void SetCaretPos (const TPoint &pos); 

Calls the Windows API function SetCaretPos to set the position of the caret 
in the coordinates of the client window. TPoint indicates the structure that 
receives the client coordinates of the caret. 

See also: TWindow.-.GetCaretPos, : -.SetCaretPos, TWindowr.ShowCaret 

inline long SetClassLong (int index) const; 

Calls the Windows API function SetClassLong to set the long value at the 
specified offset (index). Depending on the value of index, SetClassLong sets a 
handle to a background brush, cursor, icon, menu, or function. 

See also: TWindow: :GetClassLong, -.-.SetClassLong 

inline WORD SetClassWord (int index) const; 

Calls the Windows API function SetClassWord to set the word value at the 
specified offset (index). Depending on the value of index, SetClassLong sets 
the number of bytes of class, window, or style information. 

See also: TWindow.-.GetClassWord, -.-.SetClassWord 

inline BOOL SetCursor (TModule* module, TResId resld); 

Sets the cursor position for the window using the given inst and Resld. If 
the mouse is over the client area, SetCursor changes the cursor 
that's displayed. 
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SetDlgltem 



SetDlgltemText 



SetDocTitle 



SetFlag 



SetModule 



SetMenu 



The following program shows how to create a window with a custom 
cursor: 

class TCursorApp : public TApplication { 
public: 
TCursorApp () : TApplication ("CursorApp") {} 
void InitMainWindowO { 
MainWindow = new TFrameWindow (0, "Window with a Custom Cursor"); 
MainWindow->SetCursor(IDL_APPLICATION, 100) ; 
MainWindow->SetIcon(IDL_APPLICATION, 100) ; 
} 
}; 

See also: TWindow::GetCursorPos 

void SetDlgItemInt(int childld, UINT value, BOOL isSigned = TRUE) const; 

Calls the Windows API function r.SetDlgltem to set the child window with 
the Id (childld) in the window to the integer value specified in value. If 
isSigned is TRUE, the value is signed. 

See also: TWindowr.GetDlgltem, r.GetDlgltem 

void SetDlgltemText (int childld, const char far* text) const; 

Calls the Windows API function SetDlgltemText to set the text of a child 
with Id. text points to the text buffer containing the window caption or text 
that is to be copied into the child window caption or text. 

See also: TWindow: :GetDlgItemText, ::SetDlgItemText 

virtual BOOL SetDocTitle (LPCSTR docname, int index; 
Stores the title of the document. 

inline void SetFlag (TWindowFlag mask) ; 

If TRUE is supplied, the bits in Attr.Flags in Mask are set. Otherwise, the bit 
is cleared. Mask can be any one, or a combination, of the wfXxxx constants. 

See also: TWindow ::IsFlagSet 

inline void SetModule (TModule* module); 
Sets the default module ID for this window. 
See also: TWindow r.GetModule 

inline virtual BOOL SetMenu (HMENU) ; 

TWindow's implementation calls the Windows API function SetMenu to set 
the specified window's menu to the menu indicated by HMenu. If hMenu is 
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0, the window's current menu is removed. SetMenu returns if the menu 
remains unchanged; otherwise, it returns a nonzero value. 

See also: TWindow::GetMenu, TMDIFrame:: SetMenu, -.-.SetMenu 

SetParent virtual void SetParent(TWindow* newParent) ; 

Sets Parent to the specified parent window object. Removes this from the 
child list of the previous parent window, if any, and adds this to the new 
parent's child list. 

See also: TWindozv::GetParent 

SetProp inline BOOL SetProp(W0RD atom, HANDLE data) const; 

Calls the Windows API function SetProp to add an item to the property list 
of the specified window, atom contains a value that identifies the data entry 
to be added to the property list. 

See also: TWindow/GetProp, /SetProp 

SetProp inline BOOL SetProp (const char far* str, HANDLE data) const; 

Calls the Windows API function SetProp to add an item to the property list 
of the specified window, str points to the string used to identify the entry 
data to be added to the property list. 

See also: TWindow::GetProp, r.SetProp 

SetScrollPos inline int SetScrollPos(int bar, int pos, BOOL redraw = TRUE); 

Calls the Windows API function SetScrollPos to set the thumb position in 
the scroll bar. bar identifies the position (horizontal, vertical, or scroll bar 
control) to return and can be one of the Windows API SBjxxxx constants. 

See also: TWindow::GetScrollPos, -/.SetScrollPos 

SetScrollRange inline void SetScrollRange(int bar, int minPos, int maxPos, 

BOOL redraw = TRUE) ; 

Calls the Windows API function SetScrollRange to set the thumb position in 
the scroll bar. bar identifies the position (horizontal, vertical, or scroll bar 
control) to set and can be one of the Windows API SB_xxxx constants. 
minPos and maxPos specify the lower and upper range, respectively, of the 
scroll bar positions. 

See also: TWindow/GetScrollRange; /SetScrollRange 

SetSysModal Window i n ii ne HMD SetSysModalWindowO; 

Makes the indicated window a system-modal window. 

See also: TWindozv/.GetSysModalWindozv 
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SetTimer inline UINT SetTimer (UINT timerld, UINT timeout, TIMERPROC proc = 0); 

Calls the Windows API function SetTimer, which creates an event to be 
timed and enters any WM_TIMER messages into the message queue. 
timerld contains the ID number of the timer event to be entered, timeout 
specifies the length of time in milliseconds, and proc identifies the address 
of the function that's to be notified when the timed event occurs. If proc is 0, 
WM_TIMER messages are placed in the queue of the application that called 
SetTimer for this window. 

See also: TWindow.-.KUVTimer , -.-.SetTimer 

void SetTransferBuffer (void* transferBuffer); 

Sets TransferBuffer to transferBuffer. 

See also: TWindow -.-.Transfer, TWindow -.{Transfer Data 

long SetWindowLong ( int index, long newLong) ; 

Calls the Windows API function SetWindowLong to set the long value of Id 
in the WindowsAttr structure. Depending on the value of index, 
SetWindowLong sets a handle to a background brush, cursor, icon, module, 
menu, or window function. See the Windows API online Help for 
information about the GWL_xxxx values that represent styles. 

See also: TWindow: :GetWindowLong, :: SetWindowLong, 
TWindow:: Set Window Word 

SetWindOwPlacement inline BOOL SetWindowPlacement(WINDOWPLACEMENT* place); 

Calls the Windows API function SetWindowPlacement to set the window to 
the position indicated in place. 

See also: TWindow r.GetWindowPlacement, TWindow::Show 

SetWindOWPos inline void SetWindowPos (HWND hWndlnsert After, const TRect &rect, 

UINT flags); 

Calls the Windows API function SetWindowPos to change the size of the 
window pointed to by rect. flags contains one of the SWP_xxxx constants 
that specify the size and position of the window. If flags is set to 
SWP_NOZORDER, SetWindowPos ignores the hWndlnsert After parameter 
and retains the current ordering of the child, pop-up, or top-level windows. 

See also: :: SetWindowPos 

SetWindowPos inline void SetWindowPos (HWND hWndlnsertAfter, int x, int y, int w, int h, 

UINT flags) ; 
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SetWindowText 



SetWindowWord 




Show 



Calls the Windows API function SetWindowPos to change the size of the 
window pointed to by x, y, w, and h. flags contains one of the SWP_xxxx 
constants that specify the size and position of the window. If flags is set to 
SWP_NOZORDER, SetWindowPos ignores the hWndlnsertAfter parameter 
and retains the current ordering of the child, pop-up, or top-level windows. 

See also: ::SetWindowPos 

inl-ine void SetWindowText (const char far* str); 

Calls the Windows API function SetWindowText, which sets the window's 
title to a buffer pointed to by str. maxCount indicates the number of 
characters to copy into the buffer. 

See also: TWindowr.GetWindowText, -.-.SetWindowText 

WORD SetWindowWord (int index, WORD newWord) ; 

Calls the Windows API function SetWindowWord, which changes 
information about the window, index specifies a byte offset of the word to 
be changed to the new value (new Word). 

See also: TWindowr.GetWindowWord, TWindowr.SetWindowLong 

void Show (int cmdShow); 

After ensuring that the TWindow interface element has a valid handle, Show 
displays the TWindow on the screen in a manner specified by cmdShow, 
which can be one of the following values: 



Value 



Description 



ShowCaret 



SW_SHOWDEFAULT 

SW_HIDE 

SWJ/IINIMIZE 

SW_RESTORE 

SW_SHOW 

SW_SHOWMAXIMIZED 

SW_SHOWMINIMIZED 

SW_SHOWNA 

SW_SHOWMINNOACTIVE 

SW_SHOWNORMAL 

SW SHOWSMOOTH 



Show the window in its default configuration. Should be used at 

startup. 

Hide the window and activate another window. 

Minimize the window and activate the top-level window in the list. 

Same as SW_SHOWNORMAL. 

Show the window in the window's current size and position. 

Activate and maximize the window. 

Activate window as an icon. 

Display the window as it is currently. 

Display the window as an icon. 

Activate and display the window in its original size and position. 

Show the window after updating it in a bitmap. 



inline void ShowCaret (); 

Calls the Windows API function -.-.ShowCaret to display the caret in the 
specified shape in the active window at the current position. 

See also: TWindow y.CreateCaret, -.-.ShowCaret, TWindowr.HideCaret 
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ShowScrollBar 



ShowWindow 



ShowOwnedPopups void ShowOwnedPopups (BOOL show) ; 

Displays the popup window according to the value of show. See the 
function Show for a description of the SW_xxxx constants passed in show . 

See also: TWindow::Show 

inline void ShowScrollBar (int bar, BOOL show = TRUE) ; 

Calls the Windows API function ShowScrollBar to display or hide the scroll 
bar. bar specifies whether the bar is a control or part of the window's 
nonclient area. If bar is part of the nonclient area, it can be one of the 
Windows API SB_xxxx constants (specifically, SB_BOTH, SB_CTRL, 
SBJTORZ, or SB_VERT). If show is TRUE, the scroll bar is displayed; if 
FALSE, it is hidden. 

See also: TWindowr.GetScrollRange, ::ShowScrollBar 

BOOL ShowWindow ( int cmdShow) ; 

Displays the window according to the value of cmdShow. See the function 
Show for a description of the SW_xxxx constants passed in cmdShow. Show is 
the preferred method of showing the window. 

See also: TWindow::Show 

SubclassWindOWFunction void SubclassWindowFunctionO; 

Installs the instance thunk as the WindowProc and saves the old window 
function in DefaultProc. 

See also: TWindow::DefaultProc, TWindow ::DefaultProcessing 

Transfer virtual UINT Transfer (void* buffer, TTransferDirection direction); 

Transfers data to or from any window with children and returns the total 
size of the buffer. Transfer is a general mechanism for data transfer that can 
be used with or without using TransferData(). The direction supplied 
specifies whether data is to be read from or written to the supplied buffer, 
or whether the size of the transfer data is simply to be returned. Data is not 
transfered between any child windows whose wfTransfer flag is not set. If 
data is transferred, the return value is the size (in bytes) of the transfer data. 



TransferData 



See also: TWindow: -.TransferData 

virtual void TransferData (TTransferDirection direction); 

A window usually calls on TransferData during setup and closing of 
windows and relies on the constructor to set TransferBuffer to something 
meaningful. TransferData calls the Transfer member function of each 
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UnregisterHotKey 




UpdateWindow 



Validate 



ValidateRect 



ValidateRgn 



WindowFromPoint 



WindowProc 



participating child window, passing a pointer to TransferBuffer as well as 
the direction specified in direction (tdSetData, tdGetData, or tdSizeData). 

See also: TWindozv::EnableTransfer, TWindou>::DisableTransfer, 
TWindow::SetupWindow 

inline BOOL UnregisterHotKey (int idHotKey) ; 

Calls the Windows API function UnregisterHotKey to unregister a hotkey ID 
with the current application. 

See also: ::UnRegisterHotKey, TWindow r.RegisterHotKey 

inline void UpdateWindow () ; 

Calls the Windows API function UpdateWindow to update the client area of 
the specified window by immediately sending a WM_PAINT message. 

inline void Validate (); 

Calls the Windows API function ValidateRect to validate (that is, remove 
from the area to be updated) the entire client area. 

See also: TWindow::InValidate 

inline void ValidateRect (const TRect&); . 

Calls the Windows API function ValidateRect to validate a portion of the 
client area indicated by rect. 

See also: TWindowy.InvalidateRect 

inline void ValidateRgn (HRGN hRgn); 

Calls the Windows API function ValidateRgn to validate the region of the 
window indicated by hRgn. 

See also: TWindow ::InvalidateRgn 

inline static HWND WindowFromPoint (const TPoint& point) const; 

Returns a value indicating the window in which the specified point (point) 
exists. 

See also: TWindow::ChildWindowFromPoint 

virtual LRESULT WindowProc (UINT msg, WPARAM wParam, LPARAM lParam) ; 

WindowProc processes incoming messages by calling EvCommand to handle 
WM_COMMAND messages and calling EvCommandEnable to handle 
WM_COMMAND_ENABLE messages. EvCommandEnable then checks to 
see if there is a response table entry to handle the event. 

See also: TWindow: :DefWindowProc 
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BQOL WinHelp (const char far* helpFile, UINT command, DWORD data); 

Calls the Windows API function WinHelp to invoke a specified help system. 
helpFile points to a string containing the directory path and name of the 
help file, command, which indicates the type of help requested, can be one of 
the Windows Help_xxxx constants such as HELP_CONTEXT, 
HELP_HELPONHELP / HELPJNDEX, HELP_MULTIKEY, HELP_QUIT, or 
HELP_SETINDEX. data contains keywords that indicate the help topic 
items. For example, in the sample ObjectWindows file, HELP.CPP, WinHelp 
is called with the arguments HELP_CONTEXT and HELP_MENUITEMA if 
the Fl key is pressed. 

void TOwlHelpWnd: :CmMenuItemA() 
{ 
if (FlPressed) { 
WinHelp (HelpFile, HELP_CONTEXT, HELP_MENUITEMA) ; 
FlPressed = FALSE; 
} else { 

MessageBoxC'In Menu Item A command", Title, . MB_IC0NINF0RMATI0N) ; 
} 
} 

You can also include bitmaps in your Help file by referencing their file 
names or by copying them from the Clipboard. For more information about 
how to create Help files, see the online Help documentation. 



See also: :: WinHelp 



Protected data members 



Cursorlnstance 



CursorResId 



hAccel 



HCursor 



TInstance* Cursorlnstance; 

Holds the library ID for the specified cursor. A cursor ID of indicates the 
standard system cursor. 

TResId CursorResId; 

Holds the cursor resource ID for the specified cursor. Could be one of the 
Windows IDC_xxxx constants if Cursorlnstance is 0. See the Windows API 
online Help for more information about IDC_xxxx constants. 

HACCEL hAccel; 

Holds the handle to the current Windows accelerator table. 

HCURSOR HCursor; 

Holds a handle to the window's cursor. 
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TransferBuffer void* Trans ferBuffer ; 

TransferBuffer points to a buffer to be used in transferring data in and out of 
the TWindow. A TWindow assumes that the buffer contains data used by the 
windows in its child list. If 0, no data is to be transferred. See tdxxxx 
constants for a description of the transfer flags. 

See also: tdxxxx constants 



CleanupWindow 



DispatchScroll 



GetClassName 



GetWindowClass 



Protected member functions 

virtual void CleanupWindow () ; 

Called immediately before the HWindow becomes invalid, CleanupWindow 
gives derived classes an opportunity to clean up HWND related resources. 

See also: TWindow: :SetupWindow 

void DispatchScroll (UINT scrollCode, UINT thumbPos, HWND hWndCtrl) ; 
Called by EvHScroll and EvVScroll to dispatch messages from scroll bars. 
See also: TWindow::EvHScroll, TWindow: :EvVScroll 

virtual char far* GetClassName () ; 

Returns the Windows registration class name. The default class name is 
generated using "window" plus the module name. 

See also: TWindow ::GetWindowClass 

virtual void GetWindowClass (WNDCLASS &wndClass); 

Redefined by derived classes to fill the supplied Windows registration class 
structure with registration attributes. This function, along with 
GetClassName, allows Windows classes to be used for the specified 
ObjectWindows class and its derivatives. 

See also: TWindow: :GetClassName 



LoadAcceleratorTable void LoadAcceleratorTablei 



RemoveChild 



Loads a handle to the window's accelerator table specified in TWindowsAttr 
structure (Attr.AccelTable). If no handle exists, then emits an "Unable to load 
accelerator table" diagnostic message. 

See also: TWindowsAttr structure 

void RemoveChild (TWindow *); 
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SetupWindow 



See ObjectWindows 

Programmer's Guide 

for more information 

about using 

SetupWindow. 



Removes a child window. This family of ObjectWindows TWindow 
functions uses the ObjectWindows list of objects rather the Window's 
HWNDlist. 

See also: TWindowr.GetFirstChild, TWindow ::GetLastChild, TWindow: :Next, 
TWindow: -.Previous 

virtual void SetupWindow () ; 

SetupWindow is the first virtual function called when the HWindow 
becomes valid. TWindow's implementation performs window setup 
following the creation of an associated interface element. Iterates through 
the child list, attempting to create an associated interface element for each 
child window object for whom autocreation is enabled. (By default, 
autocreation is enabled for windows and controls, and disabled for dialog 
boxes.) SetupWindow then calls TransferData. 

SetupWindow can be redefined in derived classes to perform additional 
special initialization. Note that the HWindow is valid when the overridden 
SetupWindow is called and that the children's HWindows are valid after 
calling the base classes' SetupWindow function. 

See also: TFrameWindowr.SetupWindow, TComboBoxr.SetupWindow, 
TWindow ::CleanupWindow 



Response table entries 



Response table entry 



Member function 



EV_WM_CREATE 


EvCreate 


EV_WM_CLOSE 


EvClose 


EV_WM_DESTROY 


EvDestroy 


EV_WM_SIZE 


EvSize 


EV_WM_MOVE 


EvMove 


EV_WM_NCDESTROY 


EvNcDestroy 


EV_WM_QUERYENDSESSION 


EvQueryEndSession 


EV_WM COMPAREITEM 


EvCompareltem 


EV_WM_DELETEITEM 


EvDeleteltem 


EV_WM DRAWITEM 


EvDrawltem 


EV_WM_MEASUREITEM 


EvMeasureltem 


EV_WM_CHILDINVALID 


EvChildlnvalid 


EV_WM_VSCROLL 


EvVScroll 


EV_WM_HSCROLL 


EvHScroll 


EV WM PAINT 


EvPaint 


EV_WM_SETCURSOR 


EvSetCursor 


EV_WM LBUTTONDOWN 


EvLButtonDown 


EV COMMAND(CM EXIT, CmExit) 


CmExit 
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Response table entry 



Member function 



EV_WM_SYSCOLORCHANGE 

EV_WM_KILLFOCUS 

EV WM ERASEBKGND 



EvSysColorChange 

EvKillFocus 

EvEraseBkgnd 



EV_MESSAGE(WM_CTLCOLORMSGBOX,EvWin32CtlColor) 

EV_MESSAGE(WM_CTLCOLOREDIT,EvWin32CtlColor) 

EV_MESSAGE(WM_CTLCOLORLISTBOX, EvWin32CtlColor) 

EV_MESSAGE(WM_CTLCOLORBTN,EvWin32CtlColor) 

EV_MESSAGE(WM_CTLCOLORDLG J EvWin32CtlColor) 

EV_MESSAGE(WM_CTLCOLORSCROLLBAR,EvWin32CtlColor) 

EV_MESSAGE(WM_CTLCOLORSTATIC,EvWin32CtlColor) 



EvWin32CtlColor* 
EvWin32CtlColor* 
EvWin32CtlColor* 
EvWin32CtlColor* 
EvWin32CtlColor* 
EvWin32CtlColor* 
EvWin32CtlColor* 



' These response table entries are available only under the Win32 API. 



TWindow: :TXWindow class 



window.h 



A nested class, TXWIndow describes an exception that results from trying to 
create an invalid window. 



Public constructors 

Constructor TXWindow(TWindow* win = 0, UINT resourceld = IDS_INVALIDWINDOW) 

Constructs a TXWindow object with a default resource ID of 
IDS INVALIDWINDOW. 



Public data members 



Window 



TWindow* Window; 

Points to the window object that is associated with the exception. 



Public member functions 



Msg 



static string Msg (TWindow*, UINT resourceid) ; 

Converts the resource ID to a string and returns the string message. 
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TWindowFlag enum 



TWindowFlag enum window.h 

enum TWindowFlag 

wfXxxx constants define bit masks for the internally used flag attributes of 
TWindow. A wfXxxx mask is defined for each of these attributes: 



Table 1.1 



TWindow's attribute Constant Meaning if set 

masks 



wfAlias The window object is an alias for an existing HWND. 

wfAutoCreate Create window when parent window is created. 

wfFromResource Window is created from a resource definition. 

wfMainWindow Window is a main window. 

wfPredefinedClass Has a predefined Window's class. 

wfShrinkToClient Tells a frame window to shrink itself to fit around the client window. 

wfTransfer Participates in the Transfer mechanism. 

wfStreamTop Indicates the topmost window of the collection of windows to be 
streamed. 

See also: TWindow: :CreateChildren, TWindow: -.Enable AutoCreate 

TWindowAttr struct window.h 

A TWindowAttr is used to hold a TWindow's attributes that are set during 
construction. Your program controls a window's creation by passing these 
values to one of TWindow's creation routines. If the window is streamed, 
these attributes are also used for re-creation. 



Public data members 



AccelTable TResID AccelTable; 

AccelTable holds the resource ID for the window's accelerator table. 

See also: TApplication::HAccTable, TWindow r.LoadAcceleratorTable 

ExStyle DWORD ExStyle; 

ExStyle contains the extended style values of your window. These can be 
any one of the Windows API extended style constants 
(WS_EX_DLGMODALFRAME,WS_EX_NOPARENTNOTIFY, 
WS_EX_TOPMOST 7 WS_EX_SHADOW). See the Windows API online help 
for more information about these constants. 

Id int Id; 



Chapter 1, Library reference 449 



TWindowAttr struct 



Id contains the identifier of the child window; for a dialog box control Id is 
its resource identifier. If Win32 is defined, Id is set to GetWindozvLong else Id 
is set to GetWindow Word. 



Menu TResID Menu; 



Menu contains the resource identifier that is the name of the window's 
menu if one is associated with the window. 



Param char far* Param; 



Param contains a value that is passed to Windows when the window is 
created. This value identifies a data block that is then available in the 
message response functions associated with WM_CREATE. Param is used 
by TMDIClient and can be useful when converting non-ObjectWindows 
code. 



See also: TWindozv::EvCreate 
Style DWORD Style; 



Style contains the values that define the style, shape, and size of your 
window. Although TWindow sets Attr. Style to WS_CHILD and 
WS_VISIBLE, you can also use other combinations of the Windows API 
style constants. See the Windows API online help for a description of the 
WSjxxxx window creation style constants. 

X, Y, W, H int X, Y, w, H; 

X and Y contain the screen coordinates of the top left corner of the window. 
W and H contain the width and height values of the window. 

TWindowDC class dc.h 

Derived from TDC, TWindowDC is a DC class that provides access to the 
entire area owned by a window. 

Public constructors and destructor 

Constructor TWindowDC(HWND wnd) ; . 

Creates a TWindow object with the given owned window. The data member 
Wnd is set to wnd. 

See also: TWindowDC:: Wnd 

Destructor -TWindowDC ( ) ,• 
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TWindowuu class 



Destroys this object. 



Protected constructors 



Constructor TWindowDC ( ) ; 

Used for derived classes only. 

Protected data member 



Wnd 



HWND Wnd; 

Holds a handle to the window owned by this DC. 

See also: TWindowDCr.TWindowDC 



TWindowView class 



docview.h 



Derived from both TWindow and TView, TWindowView is a streamable base 
class that can be used for deriving window-based views. TWindowView's 
functions override TView's virtual function to provide their own 
implementation. By deriving a window-view class from TWindow and 
TView, you add window functionality to the view of your document. 

Public constructors and destructor 



Constructor 



Destructor 



TWindowView (TDocumentk doc, TWindow* parent = 0) ; 

Constructs a TWindowView interface object associated with the window 
view. Sets Viewld to NextViewId. Calls the associated document's AttachView 
to attach the view to the document. 

inline -TWindowView () 

Destroys a TWindowView object and calls the associated document's 
DetachView function to detach the view from the associated document. 



Public member functions 



CanClose 



inline BOOL CanClose (); 
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i vvinaowview class 



Overrides TViewr.CanClose and returns nonzero if the window can be 
closed. Checks all of the associated document's CanClose functions. These 
must return nonzero before the window view can be closed. 

See also: TView::CanClose, T 'Window: -.CanClose 

GetViewName inline LPCSTR GetViewNameO; 

Overrides TViewr.GetViewName and returns StaticName, the name of the 
view. 

See also: TViewr.GetViewName 

GetWindoW TWindow* GetWindowO 

Overrides TViewr.Get Window and returns the TWindowView object as a 
TWindow. 

See also: TEditViewr.GetWindow, TViewr.Get Window 

SetDocTitle inline BOOL SetDocTitle (LPCSTR docname, int index) 

Overrides TViewr. SetDocTitle and stores the document title. This name is 
forwarded up the parent chain until a TFrameWindow object accepts the 
data and displays it in its caption. 

See also: TViewrSetDocTitle, TWindow:: SetDocTitle 

StaticName inline static LPCSTR StaticName () ; 

Returns "Window View/' the descriptive name of the view. This title is 
displayed in the user-interface box. 



Response table entries 






Response table entry 


Member function 


EVJ/NJSWINDOW 


VnlsWindow 



TXCompatibility class 



except.h 



Describes an exception that results from setting TModuler.Status to nonzero. 
This exception is included for backward compatibility with 
ObjectWindows 1.0. 
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Public constructors 



Constructor TXCompatibility(int statusCode); 

Constructs a TXCompatibility object. 

Public member functions 



MapStatUSCodeToString static string MapStatusCodeToString(int statusCode); 
Retrieves Tmodule's status code and coverts it to a string. 

TXOwl class except.h 

TXOwl is a base class designed to describe exceptions, that is, abnormal 
conditions outside the program's control. In most cases, you will derive a 
new class from TXOwl instead of using this one directly. 

Each of the exception classes describes a particular type of exception. When 
your program encounters a given situation that's likely to produce this 
exception, it passes control to the specified exception-handling object. If 
you use exceptions in your code, you can avoid having to scatter error- 
handling procedures throughout your program. 

To create an exception handler, place the keyword try before the block of 
code that might produce the abnormal condition (the code that might 
generate an exception object) and the keyword catch before the block of 
code that follows the try block. If an exception is thrown within the try 
block, the classes within each of the subsequent catch clauses are checked 
in sequence. The first one that matches the class of the exception object is 
executed. 

The following example from MDIFILE.CPP, a sample program on your 
distribution disk, shows how to set up a try/catch block around the code 
that might throw an exception. 

void TMDIFileApp: :CmRestoreState() 
{ 
char* errorMsg = 0; 

ifpstream is(DskFile) ; 
if (is.badO) 
errorMsg = "Unable to open desktop file."; 

// try block of code // 

else { 
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if (Client->CloseChildren()) { 
try { 
is »* this; 
if (is.badO) 

errorMsg = "Error reading desktop file."; 
else 
Client->CreateChildren() ; 
} 

// catch block of code // 

catch (xalloc) { 

Client->CloseChildren() ; 

errorMsg = "Not enough memory to open file."; 
} 



if (errorMsg) 
MainWindow->MessageBox( errorMsg, "Error", MB_0K I MB_ICONEXCLAMATION) ; 



} 



See the ObjectWindows Programmer's Guide for more information about how 
to write programs using exception handlers. 

Public constructors and destructor 



Constructor 



Destructor 



inline TXOwl(const strings msg) : xmsg(msg), ResId(O); 
Constructs a TXOwl object with a string message (msg). 
TXOwl (unsigned resld, HINSTANCE instance =0); 
Constructs a TXOwl object with a resource ID. 
inline virtual -TXOwl (); 
Destroys a TXOwl object. 



Public member functions 



Clone virtual TXOwl* CloneO; 

Makes a copy of the exception object. Clone must be implemented in any 
class derived from TXOwl. 

ResourceldToString static string ResourceIdToString(BOOL* found, "unsigned resld, 

HINSTANCE instance = 0); 
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TXOwl class 



Throw 



Unhandled 



Converts the resource ID to a string and returns a string that identifies the 
exception. If the string message cannot be loaded, returns a "not found" 
message. 

virtual void ThrowO; 

Throws the exception object. Throw must be implemented in any class 
derived from TXOwl. 

virtual int Unhandled (TModule* app, unsigned promptResId) ; 

Unhandled is called when an unhandled exception is caught at the main 
message loop level. 



Vnxxxx view notification constants 



docview.h 



Table 1.36 

Vnxxxx view 

notification IDs 



The view notification constants are used to notify the view of a given event. 



Constant 



Meaning 



vnCommit Changes are committed to the document. 

vnCustomBase Base event for document notifications. 

vnDocOpened Document has been opened. 

vnDocClosed Document has been closed. 

vnlsDirty Is TRUE if uncommitted changes are present. 

vnlsWindow Is TRUE if the HWND passed belongs to this view. 

vnRevert Document's previous data is reloaded and overwrites the view's current 

data. 

vnViewOpened A new view has been constructed. 

vnViewClosed A view is about to be destroyed. 



See also: TListView, TEditView 



Voxxxx validator constants 



validate.h 



Table 1.37 

Voxxxx validator 

constants 



Validator constants represent bits in the bitmapped Options word in 
validator objects. 



Constant 



Meaning 



voFill Used by picture validators to indicate whether to fill in literal characters 

as the user types. 
voTransfer The validator handles data transfer for the input line. Currently only used 

by range validators. 
voOnAppend Used by picture validators to determine how to interact with edit controls. 

voReserved The bits in this mask are reserved. 
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xs exception status enum 



xs exception status enum applicat.h 

These bit flags define the types of exceptions that are caught and 
suspended. T Application's functions SuspendThrow and QueryThrow return 
the values of these bit flags. 

Table 1.38 — ~ ~ — ; 

xs exception status Constant Meaning 

enum ~~ ~~ ; 

xsllnknown Unknown exception 

xsBadCast Bad_cast exception 

xsBadTypeid Badjypeid exception 

xsMsg Any exception derived from xmsg 

xsAlloc xalloc exception 

xsOwl TXOwl exception 

See also: TXOwl, TApplicationr.QueryThrow, T Application: :SuspendThrow 
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Event handlers 



This chapter includes several tables that list predefined ObjectWindows 
response-table macros and event-handling functions. Each table lists the 
name of the ObjectWindows macro, any required macro arguments, and 
the associated event-handling function. The tables are organized in the 
following manner: 

Table Description Page 

2.1 Command messages 458 

2.2 Standard Windows messages 458 

2.3 Child ID notification messages 461 

2.4 Button notification messages 461 

2.5 Combo box notification messages 461 

2.6 List box notification messages 462 

2.7 Edit control notification messages 462 

2.8 Document manager messages 462 

2.9 Document view messages 463 

2.10 VBX Control messages 463 

Some event-handling functions or messages have no predefined names. In 
these cases, the generic term UserName is used to indicate that you can use 
any function name you want to as long as the function's signature matches 
the signature required by the response table macro. Similarly, the term 
UserMessage indicates that you can define your own message ID. 

This chapter uses the following conventions when listing the arguments of 
the message macros: ID refers to the child window's ID (for example, 
ID_GROUPBOX), CMD ID refers to the command ID (for example, 
CM_FILENEW), and Code refers to the notification code (for example, 
BN_CLICKED) that is being sent. 

See Chapter 5 in the ObjectWindows Programmer's Guide for information 
about creating response table entries that associate these message macros 
with their corresponding event-handling functions. 
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The following macros handle WM_COMMAND messages: 
Table 2.1 : WM_COMMAND messages 



Macro 



Macro arguments 



Response function declaration 



EV_COMMAND 

EV_COMMAND_AND_ID 

EV_COMMAND_ENABLE 

EV_MESSAGE 

EV REGISTERED 



CMD ID, UserName 
CMD ID, UserName 
CMD ID, UserName 
UserMessage, UserName 
Registered name, UserName 



void UserNameQ 

void UserNameQNP ARAM) 

void £/ser/Vame(TCommandEnabier&) 

LRESULT t/ser/Vame(WPARAM,LPARAM) 

LRESULT lfeer/Vame(WPARAM,LPARAM) 



Table 2.2 lists the macros that handle Windows messages. To determine the 
name of the Windows message that corresponds to the EV_XXXX macro, 
remove the EV_ prefix. For example, WM_ACTIVATE is the name of the 
Windows message that the EV_WM_ACTIVATE macro handles. These 
macros, which crack the standard Windows messages (break the LP ARAM 
and WPARAM parameters into separate parts), take no arguments. They 
pass the cracked parameters directly to the predefined EVxxxx message 
function. The standard Windows messages are described in your Windows 
documentation. 



Table 2.2: WM_xxxx Window messages 



Macro 



Response function declaration 



EV WM ACTIVATE 


EV_WM_ACTIVATEAPP 


EV_WM_ASKCBFORMATNAME 


EV WM CANCELMODE 


EV WM CHANGECBCHAIN 


EV WM CHAR 


EV WM CHARTOITEM 


EV WM CHILDACTIVATE 


EV WM CHILDINVALID 


EV WM CLOSE 


EV WM COMPACTING 


EV_WM_COMPAREITEM 


EV WM CREATE 


EV WM CTLCOLOR 


EV WM DEADCHAR 


EV WM DELETEITEM 


EV WM DESTROY 


EV WM DESTROYCLIPBOARD 


EV WM DEVMODECHANGE 


EV WM DRAWCLIPBOARD 


EV WM DRAWITEM 



void EvActivate(UINT active, BOOL minimized, HWND hWndOther) 

void EvActivateApp(BOOL active, HANDLE threadld) 1 

void EvActivateApp(BOOL active, HTASK hTask) 2 

void EvAskCBFormatName(UINT bufLen, char far* buffer) 

void EvCancelMode() 

void EvChangeCBChain(UINT bufLen, char far* buffer) 

void EvChar(UINT key, UINT repeatCount, UINT flags) 

int EvCharToltem(UINT key, HWND hWndListBox, UlNTcaretPos) 

void EvChildActivate() 

void EvChildlnvalid(HWND) 

void EvClose() 

void EvCompacting(UINT compactRatio) 

LRESULT EvCompareltem(UINTctrlld, COMPAREITEMSTRUCT far& 

comparelnfo) 

int EvCreate(CREATESTRUCT far &) 

HBRUSH EvCtlColor(HDC, HWND hWndChild, UINT ctlType) 

void EvDeadChar(UINT deadKey, UINT repeatCount, UINT flags) 

void EvDeleteltem(UINT ctrlld, DELETEITEMSTRUCT far& deletelnfo) 

void EvDestroy() 

void EvDestroyClipboard() 

void EvDevModeGhange(char far* devMode) 

void EvDrawClipboard() 

void EvDrawltem(UINT ctrlld, DRAWITEMSTRUCT far& drawlnfo) 
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Table 2.2: WM_xxxx Window messages (continued) 



EV_WM_DROPFILES 

EV_WM_ENABLE 

EV_WM_ENDSESSION 

EV_WM_ENTERIDLE 

EV_WM_ERASEBKGND 

EV_WM_FONTCHANGE 

EV_WM_GETDLGCODE 

EV_WM_GETMINMAXINFO 

EV_WM_GETTEXT 

EV_WM_GETTEXTLENGTH 

EV_WM_HOTKEY 

EV_WM_HSCROLL 

EV_WM_HSCROLLCLIPBOARD 

EV_WM_ICONERASEBKGND 

EVJVMJNITMENU 

EV_WM_INITMENUPOPUP 

EV_WM_INPUTFOCUS 

EV_WM_KEYDOWN 

EV_WM_KEYUP 

EV_WM_KILLFOCUS 

EV_WM_LBUTTONDBLCLK 

EV_WM_LBUTTONDOWN 

EV_WM_LBUTTONUP 

EV_WM_MBUTTONDBLCLK 

EV_WM_MBUTTONDOWN 

EV_WM_MBUTTONUP 

EV_WM_MDIACTIVATE 

EV_WM_MDICREATE 

EV_WM_MENUCHAR 

EV_WM_MENUSELECT 

EV_WM_MEASUREITEM 

EV_WM_MOUSEACTIVATE 

EV_WM_MOUSEMOVE 

EV_WM_MOVE 

EV_WM_NCACTIVATE 

EV_WM_NCCALCSIZE 

EV_WM_NCCREATE 

EV_WM_NCDESTROY 

EV_WM_NCHITTEST 

EV_WM_NCLBUTTONDBLCLK 

EV_WM_NCLBUTTONDOWN 

EV_WM_NCLBUTTONUP 

EV_WM_NCMBUTTONDBLCLK 

EV_WM_NCMBUTTONDOWN 

EV_WM_NCMBUTTONUP 

EV_WM_NCMOUSEMOVE 

EV WM NCPAINT 



void EvDropFiles(TDroplnfo droplnfo) 

void EvEnable(BOOL enabled) 

void EvEndSession(BOOL endSession) 

void EvEnterldle(UINT source, HWND hWndDIg) 

BOOL EvEraseBkgnd(HDC) 

void EvFontChange() 

UINT EvGetDlgCode() 

void EvGetMinMaxlnfo(MINMAXINFO far &) 

void EvGetText(UINT bufLen, char far* buffer) 

UINT EvGetTextLength() 

void EvHotKey(int idHotKey) 1 

void EvHScroll(UINT scrollCode, UINT thumbPos, HWND hWndCtl) 

void EvHScrollClipboard(HWND hWndCBViewer, UINT scrollCode, UINT pos) 

void EvlconEraseBkgnd(HDC) 

void EvlnitMenu(HMENU) 

void EvlnitMenuPopup(HMENU hPopupMenu, UINT index, BOOLsysMenu) 

void EvlnputFocus(BOOL gainingFocus) 1 

void EvKeyDown(UINT key, UINT repeatCount, UINT flags) 

void EvKeyUp(UINT key, UINT repeatCount, UINT flags) 

void EvKillFocus(HWND hWndGetFocus) 

void EvLButtonDblClk(UINT modKeys, TPoint& point) 

void EvLButtonDown(UINT modKeys, TPoint& point) 

void EvLButtonUp(UINT modKeys, TPoint& point) 

void EvMButtonDblClk(UINT modKeys, TPoint& point) 

void EvMButtonDown(UINT modKeys, TPoint& point) 

void EvMButtonUp(UINT modKeys, TPoint& point) 

void EvMDIActivate(HWND hWndActivated, HWND hWndDeactivated) 

LRESULT EvMDICreate(MDICREATESTRUCTfar& createStruct) 

LRESULT EvMenuChar(UINT nChar, UINT menuType) 

void EvMenuSelect(UINT menultemld, UINT flags) 

void EvMeasureltem(UINT ctrlld, MEASUREITEMSTRUCT far& measurelnfo) 

UINT EvMouseActivate(HWND hWndTopLevel, UINT hitTestCode, UINT msg) 

void EvMouseMove(UINT modKeys, TPoint& point) 

void EvMove(TPoint &clientOrigin) 

BOOL EvNCActivate(BOOL active) 

UINT EvNCCalcSize(BOOL calcValidRects, NCCALCSIZE_PARAMS far &) 

BOOL EvNCCreate(CREATESTRUCT far &) 

void EvNCDestroy() 

UINT EvNCHitTest(TPoint& point) 

void EvNCLButtonDblClk(UINT hitTest, TPoint& point) 

void EvNCLButtonDown(UINT hitTest, TPoint& point) 

void EvNCLButtonUp(UINT hitTest, TPoint& point) 

void EvNCMButtonDblClk(UINT hitTest, TPoint& point) 

void EvNCMButtonDown(UINT hitTest, TPoint& point) 

void EvNCMButtonUp(UINT hitTest, TPoint& point) 

void EvNCMouseMove(UINT hitTest, TPoint& point) 

void EvNCPaintQ 
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Table 2.2: WM_xxxx Window messages (continued) 



EV_WM_NCRBUTTONDBLCLK 

EV_WM_NCRBUTTONDOWN 

EV_WM_NCRBUTTONUP 

EV_WM_OTHERWINDOWCREATED 

EV_WM_OTHERWINDOWDESTROYED 

EV_WM_PAINT 

EV_WM_PAINTCLIPBOARD 

EV_WM_PAINTICON 

EV_WM_PALETTECHANGED 

EV_WM_PALETTEISCHANGING 

EV_WM_PARENTNOTIFY 

EV_WM_POWER 

EV_WM_QUERYDRAGICON 

EV_WM_QUERYENDSESSION 

EV_WM_QUERYNEWPALETTE 

EV_WM_QUERYOPEN 

EV_WM_RBUTTONDBLCLK 

EV_WM_RBUTTONDOWN 

EV_WM_RBUTTONUP 

EV_WM_RENDERALLFORMATS 

EV_WM_RENDERFO.RMAT 

EV_WM_SETCURSOR 

EV_WM_SETFOCUS 

EV_WM_SETFONT 

EV_WM_SETTEXT 

EV_WM_SHOWWINDOW 

EV_WM_SIZE 

EV_WM_SIZECLIPBOARD 

EV_WM_SPOOLERSTATUS 

EV_WM_SYSCHAR 

EV_WM_SYSCOLORCHANGE 

EV_WM_SYSCOMMAND 

EV_WM_SYSDEADCHAR 

EV_WM_SYSKEYDOWN 

EV_WM_SYSKEYUP 

EV_WM_SYSTEMERROR 

EV_WM_TIMECHANGE 

EV_WM_TIMER 

EV_WM_VKEYTOITEM 

EV_WM_VSCROLL 

EV_WM_VSCROLLCLIPBOARD. 

EV_WM_WINDOWPOSCHANGED 

EVJVMJVINDOWPOSCHANGING 

EV_WM_WININICHANGE 

1 WIN32 API only 
2 WIN16APIonly 



void EvNCRButtonDblClk(UINT hitTest, TPoint& point) 

void void EvNCRButtonDown(UINT hitTest, TPoint& point) 

void EvNCRButtonUp(UINT hitTest, TPoint& point) 

void EvOtherWindowCreated(HWND hWndOther) 1 

void EvOtherWindowDestroyed(HWND hWndOther) 1 

void EvPaint() 

void EvPaintClipboard(HWND, HANDLE hPaintStruct) 

void EvPaintlcon() 1 

void EvPaletteChanged(HWND hWndPalChg) 

void EvPalettelsChanging(HWND hWndPalChg) 

void EvParentNotify(UINT event, UINT childHandleOrX, UINT childlDOrY) 

int EvPower(UINT powerEvent) 

HANDLE EvQueryDraglcon() 

BOOL EvQueryEndSession() 

BOOL EvQueryNewPalette() 

BOOL EvQueryOpen() 

void EvRButtonDblClk(UINT modKeys, TPoint& point) 

void EvRButtonDown(UINT modKeys, TPoint& point) 

void EvRButtonUp(UINT modKeys, TPoint& point) 

void EvRenderAIIFormatsO 

void EvRenderFormat(UINT dataFormat) 

BOOL EvSetCursor(HWND hWndCursor, UINT hitTest, UINT mouseMsg) 

void EvSetFocus(HWND hWndLostFocus) 

void EvSetFont(HFONT) 

void EvSetText(char far* text) 

void EvShowWindow(BOOL show, UINT status) 

void EvSize(UINT sizeType, TSize& size) 

void EvSizeClipboard(HWND hWndViewer, HANDLE hRect) 

void EvSpoolerStatus(UINTjobStatus, UlNTjobsLeft) 

void EvSysChar(UINT key, UINT repeatCount, UINT flags) 

void EvSysColorChange() 

void EvSysCommand(UINT cmdType, TPoint& point) 

void EvSysDeadChar(UINT key, UINT repeatCount, UINT flags) 

void EvSysKeyDown(UINT key, UINT repeatCount, UINT flags) 

void EvSysKeyUp(UINT key, UINT repeatCount, UINT flags) 

void EvSystemError(UINT error) 

void EvTimeChange() 

void EvTimer(UINT timerld) 

int EvVKeyToltem(UINT key, HWND hWndListBox, UINT caretPos) 

void EvVScroll(UINT scrollCode, UlNTthumbPos, HWND hWndCtl) 

void EvVScrollClipboard(HWND hWndCBViewer, UINT scrollCode, UINT pos) 

void EvWindowPosChanged(WINDOWPOS far &windowPos) 

void EvWindowPosChanging(WINDOWPOS far &windowPos) 

void EvWinlniChange(char far* section) 
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The following macros handle messages that a child window sends to its 
parent: 

Table 2.3: Child ID notification messages 



Macro 



Macro arguments 



Response function declaration 



EV_CHILD_NOTIFY_AND_CODE 
EV_CHILD_NOTIFY_ALL_CODES 
EV_CHILD_NOTIFY_AT_CHILD 
EV CHILD NOTIFY 



ID, Code, UserName 
ID, UserName 
Code, UserName 
ID, Code, UserName 



void UserName{W 'ARAM) 
void Cse/7\/ame(UINT) 
void UserNameQ 
void UserNameQ 



The following button macros handle BN_xxxx notification codes. To 
determine the name of the notification code that corresponds to the 
EV_XXXX macro, remove the EV_ prefix. 



Table 2.4: Button notification messages 



Macro 



Macro arguments 



Response function declaration 



EV_BN_CLICKED 

EV_BN_DISABLE 

EV_BN_DOUBLECLICKED 

EV_BN_HILITE 

EV_BN_PAINT 

EV BN UNHIUTE 



ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 



void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 



The following combo box macros handle CBN_xxxx notification codes. To 
determine the name of the notification code that corresponds to the 
EV_XXXX macro, remove the EV_ prefix. 

Table 2.5: Combo box notification messages 



Macro 



Macro arguments 



Response function declaration 



EV_CBN. 
EV_CBN 
EV_CBN 
EV_CBN. 
EV_CBN 
EV_CBN 
EV_CBN 
EV_CBN. 
EV_CBN 
EV_CBN_ 
EV CBN 



CLOSEUP 

DBLCLK 

DROPDOWN 

EDITCHANGE 

EDITUPDATE 

ERRSPACE 

KILLFOCUS 

SELCHANGE 

SELENDCANCEL 

SELENDOK 

SETFOCUS 



ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 



void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
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The following list box macros handle LBN_xxxx notification codes. To 
determine the name of the notification code that corresponds to the 
EV_XXXX macro, remove the EV_ prefix. 

Table 2.6: List box notification messages 



Macro 



Macro arguments 



Response function declaration 



EV_LBN_DBLCLK 

EV_LBN_ERRSPACE 

EV_LBN_KILLFOCUS 

EV_LBN_SELCANCEL 

EV_LBN_SELCHANGE 

EV LBN SETFOCUS 



ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 



void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 



The following edit control macros handle EN_xxxx notification codes. To 
determine the name of the notification code that corresponds to the 
EV_XXXX macro, remove the EV_ prefix. 

Table 2.7: Edit control notification messages 



Macro 



Macro arguments 



Response function declaration 



EV_EN. 
EV_EN. 
EV_EN. 
EV_EN. 
EV_EN. 
EV_EN. 
EV_EN. 
EV EN 



CHANGE 
.ERRSPACE 
.HSCROLL 
.KILLFOCUS 
MAXTEXT 
SETFOCUS 
.UPDATE 
VSCROLL 



ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 
ID, UserName 



void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 
void UserNameQ 



The following macros handle messages generated by the document 
manager: 

Table 2.8: New document and view messages 



Macro 



Macro arguments 



Response function declaration 



EVOWLDOCUMENT 
EV_OWLNOTIFY 
EV OWLVIEW 



ID, UserName 
ID, UserName 
ID, UserName 



void L/serA/ame(TDocument& document) 
BOOL Ltee/A/ame(LPARAM&) 
void UserName(TV\ew& view) 



The following macros handle view-related messages generated by the 
document manager: See Chapter 9 in the ObjectWindows Programmer's Guide 
for more information about how to use these macros. VnHandler is a generic 
term for the view notification handler function. 
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Table 2.9: Document view messages 



Macro 



Response function declaration 



EVJ/N 
EVVN. 
EV_VN 
EV_VN 
EV_VN. 
EV_VN. 
EV_VN 
EV VN 



VIEWOPENED 

VIEWCLOSED 

DOCOPENED 

.DOCCLOSED 

COMMIT 

REVERT 

ISDIRTY 

ISWINDOW 



BOOL VnViewOpened(TView* view) 
BOOL VnViewClosed(TView* view) 
BOOL VnDocOpened(int openMode) 
BOOL VnDocClosed(int openMode) 
BOOL VnCommit(BOOL force) 
BOOL VnRevert(BOOL clear) 
BOOL VnlsDirtyO 
BOOL VnlsWindow(HWND hWnd) 



The following macros handle WM_VBXFIREEVENT messages generated 
by VBX controls. EvHandler is a generic term for a specific VBX control 
message (such as EvClick). 



Table 2.10: VBX messages 






Macro 


Macro arguments 


Response function declaration 


EV_VBXEVENTNAME 
EV_VBXEVENTINDEX 


ID, event, EvHandler 
ID, event, EvHandler 


void EvHanof/e/tVBXEVENT FAR *event) 
void Ei/Hand/e/tVBXEVENT FAR *event) 
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Dispatch functions 



See Chapter 5 in the 

ObjectWindows 

Programmer's Guide 

for more information 

about how to use 

dispatch functions. 



This chapter alphabetically lists the ObjectWindows dispatch functions. 
Dispatch functions separate the lParam and wParam parameters of 
Windows messages into their respective data types and pass control to an 
ObjectWindows member function. 

For example, when Windows sends an application a WM_CTLCOLOR 
message, the wParam is really an HDC, and the lParam has a HWND and a 
UINT hidden inside. After the dispatch function cracks the wParam and 
lParam into their constituent parts, it dispatches the Windows 
WM_CTLCOLOR message to the following ObjectWindows member 
function: 

HBRUSHEvCtlColor(HDC,HWND, UINT); 

Although dispatch functions are written for specific Windows API 
messages, they have no knowledge of the actual Windows messages they 
are sending. Instead, at run time, TEventHandler "Dispatch calls the 
appropriate dispatch function which then cracks the message and calls the 
appropriate member function, passing the response table's pmf (pointer to a 
member function) to the member function. These functions are never called 
directly. 

The following four parameters are common to all dispatch functions. 

■ GENERIC& generic is the pointer to the object (for example, TEdit). 
m GENERIC: f pmf is the pointer to the member function (for example, 

Ev Activate). 

■ WPARAM is one of the message parameters the dispatch function cracks. 

■ LPARAM is one of the message parameters the dispatch function cracks. 

The signature of the function used in the response table macro depends on 
the type of message cracking the function performs. The first letter of the 
signature indicates the return type (for example, U indicates an unsigned 
integer). The second group of letters signifies the arguments of the function 
(for example, POINT of type TPOINT, or U of type UINT). Note that the 
signature of the function serves as a template that enforces type checking. 
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The following table lists the abbreviations of the member functions' 
signatures and their corresponding data types. 

Abbreviation Data type 



V 


void 


i 


int 


U 


UINT 


B 


BOOL 


H 


HANDLE 


W 


HWND 


S 


LPSTR 



ObjectWindows uses the same dispatch functions for messages that require 
the same type of cracking. For example, both the WM_HSCROLL and 
WM_VSCROLL event handlers have void (*)( UINT, UINT, HWND) as 
their signature. The Windows message also has the wParam and lParam 
parameters in the same place. Therefore, ObjectWindows uses the same 
dispatch functions for both of these messages. See Chapter 2 for a list of 
Window messages and the corresponding ObjectWindows event handlers. 

HBRUSH_HDC_W_U_Dispatch dispatch.h 

Passes an HDC, an HWND, and a UINT and returns an HBRUSH. The 
HDC is wParam, the HWND is the LOWORD of lParam, and the UINT is 
lParam. 

LRESULT HBRUSH_HDC_WJJ_Dispatch (GENERICS generic, HBRUSH 

(GENERIC: :*pmf) (HDC, HWND, UINT), WPARAM 
wParam, LPARAM lParam) ; 

i_LPARAM_Dispatch dispatch.h 

Passes LPARAM as the only parameter and returns an int. 

LRESULT i_LPARAM_Dispatch (GENERICS generic, int (GENERIC: :*pmf) (LPARAM) , 

WPARAM wParam, LPARAM lParam) ; 

LU_W_U_Dispatch dispatch.h 

Passes a UINT, HWND, and UINT and returns an int. 
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_WPARAM_Dispatch 



LRESULT i_U_WJJ_Dispatch (GENERICS generic, int (GENERIC: :*pmf) (UINT, HWND, 

UINT) , WPARAM wParam, LPARAM lParam) ; 

i_WPARAM_Dispatch dispatch.h 

Passes WPARAM as the only parameter and returns an int. 

LRESULT i_WPARAM_Di spat ch (GENERICS generic, BOOL (GENERIC: :*pmf) (WPARAM) , 

WPARAM wParam, LPARAM lParam) ; 

LRESULT_WPARAM_LPARAM_Dispatch dispatch.h 

This dispatcher performs no message cracking. Instead, it passes wParam 
and lParam and returns an LRESULT. 

LRESULT LRESULT_WPARAM_LPARAM_Dispatch (GENERICS generic, LRESULT 

(GENERIC: :*pmf ) (WPARAM, LPARAM) , 
WPARAM wParam, LPARAM lParam) ; 

U_POINT_Dispatch dispatch.h 

U_POINT passes a reference to POINT and returns a UINT. Under WIN32, 
POINT is lParam; under WIN16, POINT is a reference to lParam. 

LRESULT U_POINT_Dispatch (GENERICS generic, UINT (GENERIC: :*pmf) (TPoint 

S), WPARAM wParam, LPARAM lParam); 

U_U_U_U_Dispatch dispatch.h 

Passes three UINTs and returns a UINT. The first UINT is wParam, the 
second UINT is the LOWORD of lParam, and the third UINT is the 
HIWORD of lParam. 

LRESULT U_U_U_U_Dispatch (GENERICS generic, 

UINT (GENERIC ::*pmf) (UINT, UINT, UINT), 
WPARAM wParam, LPARAM lParam) ; 
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U_U_U_W_Dispatch 



U_U_U_W_Dispatch dispatch.h 

Passes two UINTs and an HWND and returns a UINT. Under WIN32, the 
first UINT is the LOWORD of wParam, the second UINT is the HIWORD of 
wParam, the HWND is lParam. Under WIN16, the first UINT is wParam, 
the second UINT is the LOWORD of lParam, and the HWND is the 
HIWORD of lParam. 

LRESULT U_U_U_W_Dispatch (GENERICS generic, 

UINT" (GENERIC: :*pmf) (UINT, UINT, HWND), 
WPARAM wParam, LPARAM lParam) ; 

U.Dispatch dispatch.h 

Passes no arguments and returns a UINT. 

LRESULT U_Dispatch (GENERICS generic, UINT (GENERIC: : *pmf) (), . 
WPARAM wParam, LPARAM lParam) ; 

U_WPARAM_LPARAM_Dispatch dispatch.h 

Passes wParam and lParam and returns a UINT. 

LRESULT U_WPARAM_LPARAM_Di spat ch (GENERICS generic, 

UINT (GENERIC: :*pmf) (WPARAM, LPARAM), 
WPARAM wParam, LPARAM lParam) ; 

v_LPARAM_Dispatch dispatch.h 

Passes lParam (ignores WPARAM) as the only parameter and always 
returns 0. 

LRESULT v_LPARAM_Dispatch (GENERICS generic, 

void (GENERIC: :*pmf) (LPARAM), WPARAM wParam, 
LPARAM lParam) ; 

v_POINT_Dispatch dispatch.h 

Passes a reference to a POINT and always returns 0. Under WIN32, passes 
lParam; under WIN16, passes a reference to lParam. 
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v_POINTER_Dispatch 



LRESULT v_POINT_Dispatch (GENERIC& generic, void (GENERIC: :*pmf) (TPoint 

S) , WPARAM wParam, LPARAM lParam) ; 

v_POINTER_Dispatch dispatch.h 

Passes an LPARAM as a void* pointer and always returns 0. 

LRESULT v_POINTER_Dispatch( GENERICS generic, void (GENERIC: :*pmf) (void*) , 

WPARAM wParam, LPARAM lParam) ; 

v_U_B_W_Dispatch dispatch.h 

Passes a UINT, a BOOL, and an HWND and always returns 0. Under 
WIN32, the UINT is the LOWORD of wParam, the BOOL is the HIWORD 
of wParam, and the HWND is lParam. Under WIN16, the UINT is wParam, 
the BOOL is the HIWORD of lParam, and the HWND is the LOWORD of 
lParam. 

LRESULT v_U_B_W_Dispatch (GENERICS generic, 

void (GENERIC: :*pmf) (UINT, BOOL, HWND), 
WPARAM wParam, LPARAM lParam) ; 

v_U_POINT_Dispatch dispatch.h 

Passes a UINT and a reference to a POINT and always returns 0. UINT is 
wParam and POINT is lParam. 

LRESULT v_U_P0INT_Di spat ch (GENERICS generic, 

void (GENERIC: :*pmf) (UINT, TPoint S) , 
WPARAM wParam, LPARAM lParam) ; 

v_U_U_Dispatch dispatch.h 

Passes two UINTs and always returns 0. Under WIN 32, the first UINT is 
wParam and the second UINT is lParam. Under WIN16, the first UINT is 
wParam and the second UINT is the LOWORD of lParam. 

LRESULT v_U_U_Dispatch (GENERICS generic, 

void (GENERIC: :*pmf) (UINT, UINT), WPARAM wParam, 
LPARAM lParam) ; 
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v_U_U_U_Dispatch 



v_U_U_U_Dispatch dispatch.h 

Passes three UINTs and always returns 0. The first UINT is wParam, the 
second UINT is the LOWORD of lParam, and the third UINT is the 
HIWORD of lParam. 

LRESULT v_U_U_U_Dispatch (GENERICS generic, 

void (GENERIC: :*pmf) (UINT, UINT, UINT), 
WPARAM wParam, - LPARAM lParam) ; 

v_U_U_W_Dispatch dispatch.h 

Passes two UINTs and an HWND and always returns 0. In WIN 32, the first 
UINT is the LOWORD of wParam, the second UINT is the HIWORD of 
wParam, and the HWND is lParam. In WIN16, the first UINT is wParam, 
the second UINT is the LOWORD of lParam, and the HWND is the 
HIWORD of lParam. 

LRESULT v_U_U_W_Dispatch (GENERICS, generic, 

void (GENERIC: :*pmf) (UINT, UINT, HWND), 
WPARAM wParam, LPARAM lParam) ; 

v.Dispatch dispatch.h 

Passes no arguments and always returns 0. 

LRESULT v_v_Dispatch (GENERICS generic, void (GENERIC: :*pmf) (), 
WPARAM wParam, LPARAM lParam) ; 

v_WPARAM_Dispatch dispatch.h 

Passes WPARAM (ignores LPARAM) as the only parameter and always 
returns 0. 

LRESULT v_WPARAM_Dispatch (GENERICS generic, void (GENERIC: :*pmf) (WPARAM), 

WPARAM wParam, LPARAM lParam) ; 
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v_WPARAM_LPARAM_Dispatch 



v_WPARAM_LPARAM_Dispatch dispatch.h 

Does no message cracking (passes wParam and lParam) and always 
returns 0. 

LRESULT v_WPARAM_LPARAM_Dispatch (GENERICS generic, 

void (GENERIC: :*pmf) (WPARAM, LPARAM), - 
WPARAM wParam, LPARAM lParam) ; 

v_W_W_Dispatch dispatch.h 

Specifically designed to handle EvMDIActivate messages, v_W_W_Dispatch 
passes two HWNDs and always returns 0. Under WIN32, the first HWND 
is lParam and the second HWND is wParam. Under WIN16, the first 
HWND is the LOWORD of lParam, and the second HWND is the 
HIWORD of lparam if lParam is nonzero; otherwise, it is wParam. 

LRESULT v_W_W_Dispatch (GENERICS generic, void (GENERIC: :*pmf) (HWND, HWND), 
WPARAM wParam, LPARAM lParam) ; 
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WIN API encapsulated functions 



This chapter includes several tables listing encapsulated Windows API 
functions that take an HWND as the first argument. The tables are 
organized in the following manner: 

Table Description Page 



4.1 


Inline HWND functions 


474 


4.2 


Windows messages 


474 


4.3 


Window dimensions 


474 


4.4 


Window properties 


475 


4.5 


Window placement 


475 


4.6 


Child window placement 


476 


4.7 


Window painting 


476 


4.8 


Using scrolling and scroll bars 


476 


4.9 


Parent and child windows with IDs 


477 


4.10 


Menus and menu bars 


477 


4.11 


Clipboard placement 


477 


4.12 


Timer operations 


478 


4.13 


Caret and cursor functions 


478 


4.14 


Registering hot keys 


478 


4.15 


Miscellaneous functions 
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Most of the encapsulated functions are implemented as inline functions 
that pass the HWindow member variable as the HWND argument. The 
remaining arguments are passed without changing their prototype. 

The other functions are static functions that return information regarding 
windows. These functions don't actually use HWindow as the argument 
because the HWND is either implied or the function returns the HWND. 
An HWND that serves as a handle to an ObjectWindows window can be 
converted to a T Window* by using GetWindozvPtrQ. 

Note that in the scope of TWindow or derived class, all direct calls to the 
corresponding Windows versions of these functions must be globally 
scoped, as in ::SendMessage(). 
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The functions in Table 4.1 allow a TWindow to be used as a HWND in 
Windows API calls. 



Table 4.1: Encapsulated inline HWND functions 



Name 



Function declaration 



HWND 
IsWindow 



operator HWND () const 
BOOL IsWindow () const 



The functions in Table 4.2 handle Window messages. 
Table 4.2: Encapsulated Window messages 



Name 



Function declaration 



EnableWindow 

GetCapture 

GetFocus 

IsWindowEnabled 

PostMessage 

ReleaseCapture 

SendDlgltemMessage 

SendMessage 

SetCapture 

SetFocus 



BOOL EnableWindow (BOOL enable) 

static HWND GetCapture () 

static HWND GetFocus () 

BOOL IsWindowEnabled () const 

BOOL PostMessage (UINT msg, WPARAM wParam = 0, LPARAM IParam = 0) const 

static void ReleaseCapture () 

LRESULT SendDlgltemMessage (int childld, UINT msg, WPARAM wParam = 0, LPARAM 

IParam = 0) const 
LRESULT SendMessage (UINT msg, WPARAM wParam = 0, LPARAM IParam = 0) const 
HWND SetCapture () 
HWND SetFocus () 



Table 4.3 lists functions that adjust window coordinates and sizes. 
Table 4.3: Window coordinates and dimensions 



Name 



Function declaration 



AdjustWindowRect 

AdjustWindowRectEx 

ChildWindowFromPoint 

ClientToScreen 

GetClientRect 

GetClientRect 

GetWindowRect 

MapWindowPoints 

ScreenToClient 

WindowFromPoint 



static void AdjustWindowRect (TRect& rect, DWORD style, BOOL menu) 

static void AdjustWindowRectEx (TRect& rect, DWORD style, BOOL menu, DWORD exStyle) 

HWND ChildWindowFromPoint (const TPoint& point) 

void ClientToScreen (TPoint& point) const 

TRect GetClientRect () 

void GetClientRect (TRect& rect) 

void GetWindowRect (TRect& rect) 

void MapWindowPoints (HWND hWndTo, TPoint *points, int count) const 

void ScreenToClient (TPoint& point) const v 

static HWND WindowFromPoint (const TPoint& point) 
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Table 4.4 lists functions that encapsulate window properties and style 
attributes. 



Table 4.4: Window properties 



Name 



Function declaration 



EnumProps 

GetClassLong 

GetClassName 

GetClassWord 

GetProp 

GetProp 

GetWindowLong 

GetWindowWord 

RemoveProp 

RemoveProp 

SetClassLong 

SetClassWord 

SetProp 

SetProp 

SetWindowLong 

SetWindowWord 



int EnumProps (PROPENUMPROC proc) 

long GetClassLong (int index) const 

long GetClassName (char far* className, int maxCount) const 

WORD GetClassWord (int index) const 

HANDLE GetProp (const char far* str) const 

HANDLE GetProp (WORD atom) const 

long GetWindowLong (int index) const 

WORD GetWindowWord (int index) const 

HANDLE RemoveProp (const char far* str) const 

HANDLE RemoveProp (WORD atom) const 

long SetClassLong (int index, long newLong) 

WORD SetClassWord (int index, WORD newWord) 

BOOL SetProp (const char far* str, HANDLE data) const 

BOOL SetProp (WORD atom, HANDLE data) const 

long SetWindowLong (int index, long newLong) 

WORD SetWindowWord (int index, WORD newWord) 



Table 4.5 lists functions that encapsulate window placement and display 
properties. 

Table 4.5: Window placement 



Name 



Function declaration 



GetWindowPlacement 

GetWindowText 

GetWindowTextLength 

Islconic 

IsWindowVisible 

IsZoomed 

MoveWindow 

MoveWindow 

SetWindowPlacement 

SetWindowText 

ShowOwnedPopups 

ShowWindow 



BOOL GetWindowPlacement (WINDOWPLACEMENT *place) const 

int GetWindowText (char far* str, int maxCount) const 

int GetWindowTextLength () const 

BOOL Islconic () const 

BOOL IsWindowVisible () const 

BOOL IsZoomed () const 

void MoveWindow (const TRect& red, BOOL repaint = FALSE) 

void MoveWindow (int x, int y, int w, int h, BOOL repaint = FALSE) 

BOOL SetWindowPlacement (const WINDOWPLACEMENT *place) 

void SetWindowText (const char far* str) 

void ShowOwnedPopups (BOOL show) 

BOOL ShowWindow (int cmdShow) 
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The functions in Table 4.6 control window positions and sibling 
relationships. 



Table 4.6: Window relationships 



Name 



Function declaration 



BringWindowToTop 

GetActiveWindow 

GetDesktopWindow 

GetLastActivePopup 

GetNextWindow 

GetSysModalWindow 

GetTopWindow 

SetActiveWindow 

SetSysModalWindow 

SetWindowPos 

SetWindowPos 



void BringWindowToTop () 

static HWND GetActiveWindow () 

static H WN D GetDesktopWindow () 

HWND GetLastActivePopup () const 

HWND GetNextWindow (UINT dirFlag) const 

static HWND GetSysModalWindow () 

HWND GetTopWindow () const 

HWND SetActiveWindow () 

HWND SetSysModalWindow () 

void SetWindowPos (HWND hWndlnsertAfter, const TRect& rect, UINT flags) 

void SetWindowPos (HWND hWndlnsertAfter, int x, int y, int w, int h, UINT flags) 



The encapsulated functions in Table 4.7 control window painting 
invalidating, validating, and updating. 



Table 4.7: Window painting functions 



Name 



Function declaration 



Flash Window 

GetUpdateRect 

Invalidate 

InvalidateRect 

InvalidateRgn 

LockWindowUpdate 

RedrawWindow 

UpdateWindow 
Validate 
ValidateRect 
ValidateRgn 



BOOL FlashWindow (BOOL invert) 

BOOL GetUpdateRect (TRect& rect, BOOL erase = TRUE) const 

void Invalidate (BOOL erase = TRUE) 

void InvalidateRect (const TRect& rect, BOOL erase = TRUE) 

void InvalidateRgn (HRGN hRgn, BOOL erase = TRUE) 

BOOL LockWindowUpdate () 

BOOL RedrawWindow (TRect 'update, HRGN hUpdateRgn, UINT redrawFlags = 

RDWJNVAUDATE I RDWJJPDATENOW I RDW_ERASE) 
void UpdateWindow () 
void Validate () 

void ValidateRect (const TRect& rect) 
void ValidateRgn (HRGN hRgn) 



The functions in Table 4.8 control window scrolling and scroll bars. 
Table 4.8: Window scrolling functions 



Name 



Function declaration 



GetScrollPos 
GetScrollRange 
ScrollWindow 
ScrollWindowEx 



int GetScrollPos (int bar) 

void GetScrollRange (int bar, int &minPos, int &maxPos) const 
void ScrollWindow (int dx, int dy, const TRect *scroll = 0, const TRect *clip = 0) 
void ScrollWindowEx (int dx, int dy, constTRect *scroll = 0, const TRect *clip = 0, HRGN 
hUpdateRgn = 0, TRect 'update = 0, UINT flags = 0) 
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Table 4.8: Window scrolling functions (continued) 



SetScrollPos 

SetScrbllRange 

ShowScrollBar 



int SetScrollPos (int bar, int pos, BOOL redraw = TRUE) 

void SetScrollRange (int bar, int minPos, int maxPos, BOOL redraw = TRUE) 

void ShowScrollBar (int bar, BOOL show = TRUE) 



The functions in Table 4.9 control parent and child windows usin£ 
command IDs. 



Table 4.9: Child window ID functions 



Name 



Function declaration 



CheckDIgButton 

CheckRadioButton 

GetDlgCtrllD 

GetDlgltem 

GetDlgltemlnt 

GetDlgltemText 

GetNextDlgGroupltem 

GetNextDlgTabltem 

GetParent 

IsChild 

IsDIgButtonChecked 

SetDlgltemlnt 

SetDlgltemText 



void CheckDIgButton (int buttonld, UINT cheqk) 

void CheckRadioButton (int firstButtonld, int lastButtonld, int checkButtonld) 

int GetDlgCtrllD () const 

HWND GetDlgltem (int childld) const 

UINT GetDlgltemlnt (int childld, BOOL* translated, BOOL isSigned) const 

int GetDlgltemText (int childld, char far* text, int max) const 

HWND GetNextDlgGroupltem (HWND hWndCtrl, BOOL previous = FALSE) const 

HWND GetNextDlgTabltem (HWND HWndCtrl, BOOL previous = FALSE) const 

HWND GetParent () const 

BOOL IsChild (HWND) const 

UINT IsDIgButtonChecked (int buttonld) const 

void SetDlgltemlnt (int childld, UINT value, BOOL isSigned = TRUE) const 

void SetDlgltemText (int childld, const char far* text) const 



The functions in Table 4.10 control menus and menu bar operations. 
Table 4.10: Menu and menu bar functions 



Name 



Function declaration 



DrawMenuBar 

GetMenu 

GetSystemMenu 

HiliteMenultem 

SetMenu 



void DrawMenuBar () 

HMENU GetMenu () 

HMENU GetSystemMenu (BOOL revert = FALSE) 

BOOL HiliteMenultem (HMENU, UINT idltem, UINT hilite) 

BOOL SetMenu (HMENU) 



Table 4.11: 


The function in Table 4.11 controls 
Clipboard functions 


Clipboard 


operations. 


Name 






Function declaration 






&OpenClipboard 




TCIipboard &OpenClipboard () 
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The functions in Table 4.12 control timer operations. 



Table 4.12: Timer functions 



Name 



Function declaration 



KillTimer 
SetTimer 



BOOL KillTimer (UINT timerld) 

BOOL SetTimer (UINT timerld, UINT timeout, TIMERPROC proc = 0) 



The functions in Table 4.13 control caret and cursor operations. 
Table 4.13: Caret and cursor functions 



Name 



Function declaration 



CreateCaret 

CreateCaret 

DestroyCaret 

GetCaretBlinkTime 

GetCaretPos 

GetCursorPos 

HideCaret 

SetCaretBlinkTime 

SetCaretPos 

SetCaretPos 



void CreateCaret (HBITMAP) 

void CreateCaret (int shade, int width, int height) 

static void DestroyCaret () 

static UINT GetCaretBlinkTime () 

static void GetCaretPos (TPoint& pos) 

static void GetCursorPos (TPoint& pos) 

void HideCaret () 

static void SetCaretBlinkTime (WORD milliSecs) 

static void SetCaretPos (const TPoint& pos) 

static void SetCaretPos (int x, int y) 



The functions in Table 4.14 control the operation of hot keys. 
Table 4.1 4: Hot key functions 



Name 



Function declaration 



RegisterHotKey 
UnregisterHotKey 
1 WIN32 API only 



BOOL RegisterHotKey (int idHotKey, UINT modifiers, UINT virtKey) 1 
BOOL UnregisterHotKey (int idHotKey) 1 



The functions in Table 4.15 control miscellaneous operations such as 
accessing WinHelp. 

Table 4.1 5: Help and task functions 



Name 



Function declaration 



DragAcceptFiles 

GetWindowTask 

GetWindowTask 

MessageBox 

WinHelp 

1 WIN32 API only 
2 WIN16APIonly 



void DragAcceptFiles (BOOL accept) 

HANDLE GetWindowTask () const 1 

HTASK GetWindowTask () const 2 

int MessageBox (const char far* text, const char far* caption = 0, UINT type = MB_OK) 

BOOL WinHelp (const char far* helpFile, UINT command, DWORD data) 



478 



ObjectWindows 2.0 Reference Guide 



Inheritance diagrams 



This chapter contains the ObjectWindows inheritance diagrams arranged in 
alphabetical order. Use these diagrams to see the functions that are new or 
redefined for a particular class. You can tell which virtual functions are 
inherited by a derived class and which virtual functions are declared in the 
most derived class. The most derived class is the one enclosed in double 
lines. 

Functions that are defined as virtual in the derived class are underlined. 
Functions that are declared in a parent class and overridden in a derived 
class are shaded in the parent class. By definition, these shaded functions 
are also defined as virtual functions. For example, the virtual function 
TGadget Window: :Paint overrides the virtual function TWindow::Paint. 
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TDC member function 94 
classes 

access specifiers 3 

event handling 18 

icons 2 

inline functions 3 

names 

client window registration 266 
edit controls registration 181 
interface objects registration 446 
list boxes registration 254 
modal and modeless dialog box 143 
static control registration 375 

scope resolution operator 3 

TBrush 46 

TColor 72 

TDropInfo 169 

TGdiObject 224 

TIcon 233 

TMetaFilePict 278 

TPalette 293 

TPaletteEntry 297 

TPen 298 

TPoint 301 

TPointer 304 

TRect 338 

TRegion 345 

TResID 350 

TRgbQuad 352 

TRgbTriple 353 

TSize 363 

windows 

input dialog 236 

Windows registration 435 
ClassExpert 

command notifications 16, 17, 18 

document styles 20 
_CLASSTYPE macro 449 
Cleanup Window 

TWindow member function 416,446 
Clear 

TComboBox member function 77 



TStatic member function 374 
ClearDevice 

TPrinter member function 328 
ClearDevMode 

TPrintDialog::TData member function 322 
ClearDevNames 

TPrintDialog::TData member function 322 
ClearFlag 

TDocTemplate member function 157 

TWindow member function 417 
clearing bits 45 
ClearList 

TComboBox member function 77 

TListBox member function 249 
ClearModify 

TEdit member function 1 75 
client window 206 

arranging icons 263 

attributes 263 

cascading children 264 

closing children 264 

moving through 203 

registration class name 266 

tiling children 265 
client windows 136 

handles, returning 283 
ClientAttr 

TMDIClient data member 263 
ClientSize 

TLayoutWindow data member 248 
ClientToScreen 

TWindow member function 417 
ClientWnd 

TFrame Window data member 206 
clip 

TGadget data member 208 
Clipboard 

activating 69 

text and 175, 177, 178 

viewer chain 71 

windows 

adding 70, 71 
identifying 68 

owner 68 
removing 71 

Windows API encapsulation 67 
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Clone 

TXInvalidMain Window public member 

function 39 

TXOwl public member function 454 
Close 

TDocument member function 164 

TFileDocument member function 192 

TMetaFileDC member function 278 
close boxes, creating 383, 384, 389 
CloseBox 

TTinyCaption data member 384 
CloseChildren 

TMDIClient member function 264 
CloseClipboard 

TClipboard member function 67 
CloseFigure 

TDC member function 95 
CloseThisFile 

TFileDocument member function 194 
CloseWindow 

TDialog member function 140 

TWindow member function 417 
CM_ARRANGEICONS message 265 
CM_CASCADECHILDREN message 265 
CM_CLOSECHILDREN message 265 
CM_CREATECHILD message 265 
CM_EXIT message 417 
CM_FILESAVEAS message 183 
CM_TILECHILDREN message 265 
CM_xxxx edit file constants 1 7 
CM_xxxx edit replace constants 17 
CM_xxxx MDI constants 18 
CMArrangelcons 

TMDIClient member function 265 
CmCancel 

TDialog member function 140 

TFindReplaceDialog member function 1 98 
CMCascadeChildren 

TMDIClient member function 265 
CMChildActionEnable 

TMDIClient member function 265 
CMCloseChildren 

TMDIClient member function 265 
CMCreateChild 

TMDIClient member function 265 
cmdLine 

TApplication data member 31 



cmdShow 

TApplication data member 32 
CmEditAdd 

TListView member functions 257 
CMEditClear 

TEdit member function 180 
CmEditClear 

TListView member functions 258 
CmEditCopy 

TEdit member function 180 

TListView member functions 257 
CmEditCut 

TEdit member function 180 

TListView member functions 258 
CmEditDelete 

TEdit member function 180 

TListView member functions 258 
CmEditFind 

TEditSearch member function 186 
CmEditFindNext 

TEditSearch member function 186 
CmEditltem 

TListView member functions 258 
CmEditPaste 

TEdit member function 180 

TListView member functions 258 
CmEditReplace 

TEditSearch member function 186 
CmEditUndo 

TEdit member function 180 

TListView member functions 258 
CmExit 

TWindow member function 417 
CmFileClose 

TDocManager member function 153 
CmFileNew 

TDocManager member function 754 

TEditFile member function 183 
CmFileOpen 

TDocManager member function 154 

TEditFile member function 183 
CmFileRevert 

TDocManager member function 154 
CmFileSave 

TDocManager member function 154 

TEditFile member function 183 
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CmFileSaveAs 

TDocManager member function 154 

TEditFile member function 183 
CmFindNext 

TFindReplaceDialog member function 198 
CmFontApply 

TChooseFontDialog member function 64 
CmHelp 

TCommonDialog member function 83 
CmLbSelChanged 

TOpenSaveDialog member function 289 
CmOk 

TDialog member function 141 

TOpenSaveDialog member function 289 
CmOkCancel 

TCommonDialog member function 83 
CmReplace 

TFindReplaceDialog member function 198 
CmReplaceAll 

TFindReplaceDialog member function 1 98 
CmSelChange 

TListView member functions 258 
CmSetup 

TPrintDialog data member 320 
CMTileChildren 

TMDIClient member function 265 
CMTileChildrenHoriz 

TMDIClient member function 266 
CmViewCreate 

TDocManager member function 154 
Color 

TChooseColor Dialog: :TData data member 63 

TChooseFontDialog: :TData data member 65 
color count 

NColors 27 
color-matching functions 326 
colors 

selecting 61 
combo boxes 

creating 76 

entries, transferring 80, 81 

lists 

showing 80 

owner-draw 84, 85 

size 85 

styles 76 
command-based message constants 16 



CommandEnable 

called by TGadgetWindow 216 

TButtonGadget member function 51 

TGadget data member 210 
CommDlgExtendedError codes 199, 321 
Commit 

TDocument member function 164 

TFileDocument member function 1 92 
Compareltem 

TControl member function 84 
complement operator 

used in TBitSet 46 
concatenating strings 255 
Condemn 

TApplication member function 34 
configuring 

printers 319, 328 
constants 

buffer, transfer data 39 1 

button flags 16 

command messages 16 

event 191 

exception messages 24 

resource IDs 

accelerator keys 23 
menu commands 23 

TPrintDialog: :TData struct 32 1 

transfer functions 391 

TWindow 
flags 449 

validator 455 
constraints 

defined 24 1 

edge 171,241,244 

layout 239, 241 
constructor 

sample 8, 9 

TDocTemplateT member function 161 

TInStream class 236 

TOutStream class 292 

TPreviewPage class 307 

TPrintPreviewDC class 324 
Constructors 

TBitmapGadget class 44 
constructors 

TApplication class 32, 33 

TBitmap40 
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TBitSet class 45 
TBrush 47 
TButton class 49 
TCelArray class 55 
TCharSet class 57 
TCheckBox class 58 
TChooseColorDialog class 61 
TChooseFontDialog class 64 
TClientDC 67 
TClipboard class 70 
TClipboardViewer class 71 
TColor 73 

TComboBox class 76, 77 
TComboBoxData class 81 
TCommonDialog class 82 
TControl class 84 
TControlGadget class 88 
TCreatedDC 89 
TCursor 90 
TDC 92, 135 

TDecoratedFrame class 136 
TDecoratedMDIFrame class 138 
TDesktopDC 139 
TDialog class 140 
TDib 146 
TDibDC 151, 152 
TDocManager class 153 
TDocTemplate class 160 
TDocument::List class 169 
TDocument class 163 
TDropInfo 169 
TEdit class 174 
TEditFile class 182 
TEditSearch class 185 
TEditView class 187 
TEventlnfo 191 
TFileDocument class 192 
TFileOpenDialog class 195 
TFileSaveDialog class 195 
TFilter Validator class 196 
TFindDialog class 197 
TFindReplaceDialog class 198 
TFont 202 

TFrame Window class 204 
TGdiObject 227 
TGroupBox class 231 
TIC 233 



TIcon 234 

TInputDialog class 236 
TLayoutMetrics class 242 
TLay out Window class 247 
TListBox class 248, 249 
TListBoxData structure 255 
TListView class 256 
TLookup Validator class 260 
TMDIChild class 261 
TMDIClient class 263 
TMDIFrame class 267 
TMemoryDC 269 
TMenu class 270, 271 
TMenuDescr 275 
TMetaFileDC 277 
TMetaFilePict 278 
TModule class 28 1 
TOpenSaveDialog class 288 
TPaintDC 292 
TPalette293 
TPaletteEntry 298 
TPen 299 
TPoint 301 
TPointer class 304 
TPopupMenu class 305 
TPrintDC 308 
TPrintDialog class 319 
TPrinter class 327 
TPrinterAbortDlg class 329 
TPrintout class 330 
TProcInstance class 333 
TPXPicture Validator class 333 
TRadioButton class 336 
TRange Validator class 337 
TRect 339 
TRegion 345 
TReplaceDialog class 349 
TResID 350 
TRgbQuad 352 
TRgbTriple 353 
TScreenDC 354 
TScrollBar class 355 
TScroller class 359 
TSize 363 
TSlider class 367 
TStatic class 373, 374 
TStarusBar class 376 



542 



ObjectWindows 2.0 Reference Guide 



TStringLookup Validator class 379 

TSystemMenu class 380 

TTinyCaption class 385 

TValidator class 392 

TVbxControl class 396 

TView class 408 

TWindow class 414 

TWindowDC 450, 451 

TWindow View class 451 
ContainerGroup 

TMenuDescr enum 276 
Contains 

TRect member function 340 

TRegion member function 346 
contents 

summary 1 
Control 

TControlGadget data member 88 
control bar button gadgets 86 
control IDs 

TInputDialog 22 
controls 84 

drawing 85, 86 

ID 

retrieval 142 

managing 230 
converting 

horizontal scrollbar range value 361 

range values to scroll values 26 

scroll values to range values 26 

vertical scrollbar range value 362 
Copies 

TPrintDialog::TData struct data member 321 
Copy 

TEdit member function 175 
CopyCursor 

TModule member function 282 
Copylcon 

TModule member function 282 
copying exception objects 39 
CountClipboardFormats 

TClipboard member function 68 
cracking messages 457 
cracking Windows messages 465 
Create 

TDialog member function 141 

TEdit View member function 187 



TGadget Window member function 219 

TListView member function 256 

TMDIClient member function 264 

TPalette member function 297 

TWindow member function 417 
CreateAbortWindow 

TPrinter member function 329 
CreateAnyDoc 

TDocManager member function 154 
CreateAnyView 

TDocManager member function 154 
CreateCaret 

TWindow member function 477 
CreateChild 

TMDIClient member function 264 
CreateChildren 

TWindow member function 417 
CreateDialogParam function 141 
CreateDoc 

TDocTemplate member function 158, 161 
CreateView 

TDocTemplate member function 158 

TDocTemplateT member function 161 
creating 

dialog boxes 

abort 328, 329, 332 
printsetup 319,321 

status bars 376 
creating DCs using TCreateDC 92 
creating HDCs 89 
CSize 

TCelArray data member 57 
CTL3D DLL 34 
CTL3D DLL support 139 
CtBdEnabled 

TApplication member function 34 
CurrentPreviewFont 

TPrintPreviewDC data member 327 
Cursorlnstance 

TWindow data member 445 
CursorResId 

TWindow data member 445 
cursors 

default 143 

loading into memory 285 

position, inserting text at current 1 77 
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CustColors 

TChooseColorDialog::TData data member 63 
CustomFilter 

TOpenSaveDialog::TData struct 290 
Cut 

TEdit member function 1 75 



Data 

TChooseColorDialog data member 62 

TChooseFontDialog data member 64 

TFindReplaceDialog data member 198 

TOpenSaveDialog data member 288 

TPrintDialog data member 320 

TPrinter data member 328 
data 

Clipboard, retrieving 68 

manipulating 67 

retrieving 283 

storing 

document modes 27 

transfer 338, 393 

transfer mechanism 84 

validating entries 391 

input fields 335, 336, 379, 393, 394 
numeric values only 337 
picture strings 333 
data member 

sample 8, 9 
DC 

TChooseFontDialog: :TData data member 65 

TPrintout data member 332 
DECLARE_RESPONSE_TABLE macro 18 

TChooseColorDialog class 62 

TClipboardViewer class 72 
default error handling 280 
default message processing 

windows 413 
default printers 31 9, 327 

updating 329 
DefaultProc 

TWindow data member 413 
DefaultProcessing 

TWindow member function 418 
DefaultProtocol 

TClipboard data member 67 



DefExt 

TOpenSaveDialog: :TData struct 290 
DEFINE_DOC_TEMPLATE_CLASS macro 18 
DEFINE_RESPONSE_TABLEl macro 

TChooseFontDialog class 65 
DEFINEJRESPONSEJTABLE2 macro 

TDecoratedFrame class 138 
DEFINE_RESPONSE_TABLE macro 

TDocManager class 157 
DEFINE_RESPONSE_TABLE macros 19 
DefWindowProc 

TDecoratedMDIFrame member function 138 

TMDIChild member function 262 

TMDIFrame member function 268 

TWindow member function 420 
Deleteltem 

TControl member function 85 
DeleteLine 

TEdit member function 1 75 
DeleteMenu 

TMenu member function 271 
DeleteSelection 

TEdit member function 175 
DeleteString 

TComboBox member function 77 

TListBox member function 249 
DeleteSubText 

TEdit member function 1 75 
DeleteTemplate 

TDocManager member function 155 
DeltaPos 

TScrollBar member function 355 
describing menu groups 273 
Destroy 

TDialog member function 141 

TDocument::List member function 169 

TMDIChild member function 261 

TWindow member function 421 
DestroyCaret 

TWindow member function 421 
destructor 

sample 8 

TFileDocument class 192 

TProcInstance class 333 
destructors 

TApplication class 33 

TBitmapGadget class 44 
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TCelArray class 55 

TClipboard class 70 

TComboBoxData class 81 

TControlGadget class 88 

TCreatedDC 89 

TCursor 91 

TDC93 

TDialog class 140 

TDib 147 

TDocTemplate class 160 

TDocument::List class 169 

TDocument class 163 

TEditFile class 182 

TEditView class 187 

TFrame Window class 204 

TGdiObject 228 

TIcon 234 

TLayoutWindow class 247 

TListBoxData structure 255 

TListView class 256 

TMDIChild class 261 

TMDIClient class 263 

TMenu class 271 

TMetaFileDC 278 

TMetaFilePict 279 

TModule class 28 1 

TPaintDC 293 

TPrinter class 327 

TPrintout class 330 

TScroller class 360 

TSlider class 367 

TStringLookup Validator class 379 

TTinyCaption class 385 

TValidator class 392 

TVbxControl class 397 

TView class 408 

T Window class 415 

TWindowDC 450 

TWindowView class 451 
DetachStream 

TDocument data member 168 
DeviceCapabilities 

TPrintDC associated function 309 
DEVMODE structure 

locking memory 323 

pointer to 323 

unlocking memory 323 



DEVNAMES structure 

locking memory 323 

pointer to 323 

unlocking memory 323 
dialog boxes 

closing 140, 142 

creating 6 1, 63, 141 
abort 328, 329, 332 
modeless 349 
print setup 319,321 

CTL3D DLL 139 

executing 14 1, 142 
precautions 283 

file management 182, 195 

finding text 197 

initializing 62, 64, 140, 142, 199 

input 235 

interface elements 14 1 

items 
changing 185 
handles 142 
sending messages to 143 

messages, processing 14 1, 142 

modal 139, 140 

modeless 61, 63, 139, 140, 197 

naming 236 
dialog windows, windows class 236 
DialogBoxParam function 142 
DialogFunction 

TChooseColor Dialog member function 62 

TChooseFontDialog member function 64 

TDialog member function 141 

TFindReplaceDialog member function 199 

TOpenSaveDialog member function 289 

TPrintDialog member function 320 
DIB 

array of eels 55 
Direction 

TGadgetWindow data member 218 
direction for tiling 383 
DirectoryList 

TComboBox member function 77 

TListBox member function 249 
DirtyFlag 

TDocument data member 168 

TListView data member 256 
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DirtyLayout 

TGadgetWindow data member 218 
DisableAutoCreate 

TWindow member function 421 
Disableltem 

TBitSet member function 45 
DisableTransfer 

TWindow member function 427 
disabling CTL3D DLL 34 
Dispatch 

TEventlnfo data member 190 
dispatch function 

description 465 
dispatch functions 

HBRUSH_HDC_W_U_Dispatch 466 

i_LPARAM_Dispatch 466 

i_U_W_U_Dispatch 466 

i_WPARAM_Dispatch 467 

LRESULT_WPARAM_LPARAM_Dispatch 467 

U_Dispatch 468 

U_POINT_Dispatch 467 

U_U_U_U_Dispatch 467 

U_U_U_W_Dispatch 468 

U_WPARAM_LPARAM_Dispatch 468 

v_Dispatch 470 

v_LPARAM_Dispatch 468 

v_POINT_Dispatch 468 

v_POINTER_Dispatch 469 

v_U_B_W_Dispatch 469 

v_U_POINT_Dispatch 469 

v_U_U_Dispatch 469 

v_U_U_U_Dispatch 470 

v_U_U_W_Dispatch 470 

v_W_W_Dispatch 471 

v_WPARAM_Dispatch 470 

v_WPARAM_LPARAM_Dispatch 471 
Dispatcher 

TResponseTableEntry data member 351 
dispatching Window messages 465 
DispatchScroll 

TWindow member function 446 
display contexts 

window, painting 434 
displaying 

current state, program 376, 377 
DLLs 

building 28 



error handling 280 

exporting 29 

importing 29 

modules 
handles, returning 286 
object-oriented stand-in 280 

wf Alias and 449 
dmxxxx manager mode constants 19 
dnxxxx document message enum 20 
Doc 

TStream data member 379 

TView data member 410 
DOCINFO 

struct 319 
Doclnfo 

TPrintDC data member 319 
DocList 

TDocManager data member 153 
DoCommand 

TTinyCaption member function 385 
DoCreate 

TCommonDialog member function 82 

TDialog member function 141 

TFindDialog member function 197 

TFindReplaceDialog member function 199 

TReplaceDialog member function 349 
DocTitlelndex 

TFrame Window data member 206 
document manager 

creating 152 
document paths 

and TFileDocument 193 
documents 

closing 20 

creating 20, 157 

creating templates 160 

interfaces 407 

manager mode constants 19 

message enum 20 

naming 410 

open modes 
ofxxxx constants 27 

property attributes 28 

sharing modes, shxxxx constants 30 

string ID constants 23 

templates, creating 18 

view constants 20 
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viewing 407, 451 

without associated files 162 
DoExecute 

TChooseColorDialog member function 62 

TChooseFontDialog member function 64 

TCommonDialog member function 82 

TDialog member function 141 

TFileOpenDialog member function 195 

TFileSaveDialog member function 196 

TOpenSaveDialog member function 289 

TPrintDialog member function 319 
DoKeyDown 

TKeyboardModeTracker data member 238 
DoLButtonUp 

TTinyCaption member function 385 
DoMouseMove 

TTinyCaption member function 385 
DoNCActivate 

TTinyCaption member function 385 
DoNCCalcSize 

TTinyCaption member function 385 
DoNCHitTest 

TTinyCaption member function 386 
DoNCLButtonDown 

TTinyCaption member function 386 
DoNCPaint 

TTinyCaption member function 386 
DoSearch 

TEditSearch member function 186 
DoSetFocus 

TKeyboardModeTracker data member 238 
DoSysCommand 

TTinyCaption member function 386 
DoSysMenu 

TTinyCaption member function 386 
DownHit 

TTinyCaption data member 384 
DPtoLP 

TDC member function 95 
Drag 

TVbxControl member function 397 
DragAcceptFiles 

TWindow member function 421 
DragFinish 

TDropInfo member function 1 70 
DragQueryFile 

TDropInfo member function 1 70 



DragQueryFileCount 

TDropInfo member function 1 70 
DragQueryFileNameLen 

TDropInfo member function 170 
DragQueryPoint 

TDropInfo member function 1 70 
DrawFocusRect 

TDC member function 95 
Drawlcon 

TDC member function 95 
drawing 

owner-draw controls 85, 86 
drawing gauges 224 
Drawltem 

TControl member function 85 
DRAWITEM message 85 
DrawMenuBar 

TWindow member function 422 
DrawText 

TDC member function 95 
dtxxxx constants 20 

dual DC synchronizing functions 324, 327 
dynamic-link libraries (DLLs) 280 



edge constraints, creating windows 1 71, 241, 244 
edit controls 173,185 
attributes 

setting 174, 178 
closing 179 
first visible line 175 
formatting rectangle 177,178 
handles 178 

data 175 
notification codes 180 
password 176, 178 
registration class name 181 
tab stop positions 1 79 
text 

clearing 1 80 

copying 175,180 

cutting 175, 180 

deleting 180 
lines 175 

getting 176 / 

inserting 177 

limiting 181 
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line index 176 
line length 176 
modified 177 
number of lines 176 
pasting 178, 180 
position 174, 176 
scrolling 178 
selected 

deleting 175 
getting 177 
selecting 179 
undoing 180 
undoing 174, 175, 179 
word break 179 
word wrapped lines 175, 177 
EditGroup 

TMenuDescr enum 276 
editing windows 

resources and associating with objects 1 74 
Ellipse 

TDC member function 97 
EmptyClipboard 

TClipboard member function 68 
EmptyUndoBuffer 

TEdit member function 1 75 
EN_ERRSPACE constant 180 
enable 3-D support 143 
EnableAutoCreate 

TWindow member function 422 
EnableBWCC 
and TDialog 140 

TApplication member function 34 
EnableCtl3d 

TApplication member function 34 
EnableCtl3dAutosubclass 

TApplication member function 34 
Enableltem 

TBitSet member function 45 
EnableKBHandler 

TFrame Window member function 204 
EnableMenuItem 

TMenu member function 271 
EnableTinyCaption 

TTinyCaption member function 386 
EnableTransfer 

TWindow member function 422 



encapsulated functions 

GetParent 428 

GetProp 428, 440 

WIN API 473 
encapsulation 

Windows API Clipboard functions 67 
end-of-line characters 1 75 
END_RESPONSE_TABLE macro 2 1 
EndDialog function 141 
EndDoc 

TPrintDC member function 312 
EndDocument 

TPrintout member function 331 
EndModal 

TApplication member function 34 
EndPage 

TPrintDC member function 312 
EndPath 

TDC member function 97 
EndPrinting 

TPrintout member function 331 
EndView 

TScroller member function 360 
ENErrSpace 

TEdit member function 180 
Entry 

TEventlnfo data member 191 
enum 

TMeasurementUnits 269 

TMenuDescr 276 

TRelationshipUnits 349 

TWidthHeight472 

TWindowFlag 449 
EnumFontFamilies 

TDC member function 97 
EnumFonts 

TDC member function 97 
EnumMetaFile 

TDC member function 98 
EnumObjects 

TDC member function 98 
EnumProps 

TWindow member function 422 
Error 

TChooseColor Dialog: :TData data member 63 

TChooseFontDialog::TData data member 65 

TFilter Validator member function 196 
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TFindReplaceDialog::TData member function 

199 

TModule member function 282 

TOpenSaveDialog::TData struct 290 

TPrintDialog::TData struct data member 321 

TPrinter data member 328 

TPXPicture Validator member function 334 

TRange Validator member function 337 

TStringLookupValidator member function 380 

TValidator member function 392 
error codes 

TFinReplaceDialog::TData structure 199 

TPrintDialog class 321 

TPrinter class 
returning 328 
error messages 

displaying 282 

maximum number of characters 26 
error strings 26 
errors 

default handing 280 
Escape 

TPrintDC member function 313 
esComplete 191 
esPartial 191 
EV_CHILD_NOTIFY 22 
EV_CHILD_NOTIFY_ALL_CODES 22 
EV_CHILD_NOTIFY_AND_CODE 22 
EV_CHILD_NOTIFY_AT_CHILD 22 
EV_COMMAND 22 
EV_COMMAND_AND_ID 22 
EV_COMMAND_ENABLE 22 
EV_MESSAGE 22 
EV_OWLDOCUMENT 22 
EVJDWLNOTIFY 22 
EVJDWLVIEW 22 
EV_REGISTERED 22 
EV_VBXEVENTINDEX 404 
EV_VBXEVENTNAME 404 
EVjxxxx macros 21 
EvButtonDown 

TGadget Window member function 21 9 
EvButtonUp 

TGadgetWindow member function 219 
EvCanClose 

TDocManager member function 155 



EvChangeCBChain 

TClipboard Viewer member function 71 
EvChar 

TEdit member function 180 
EvChildlnvalid 

TWindow member function 422 
EvClose 

TCommonDialog member function 83 

TDialog member function 1 42 
EvClose message 142 
EvCommand 

TDecoratedFrame member function 137 

TFrame Window member function 206 

TPrinter AbortDlg member function 330 

TTinyCaption member function 387 

TWindow member function 422 
EvCommandEnable 

TDecoratedFrame member function 137 

TFrame Window member function 206 

TWindow member function 422 
EvCtlColor 

TDialog member function 143 
EvCtlColor message 143 
EvDestroy 

TClipboardViewer member function 71 
EvDrawClipboard 

TClipboardViewer member function 71 
event constants 191 
event handling 

finding events 1 90, 191 
event-handling functions 457 
event IDs 

and views 455 
event tables 162 
EvEnterldle 

TDecoratedFrame member function 137 
eventhan.h 

event handlers 457 
events 

handling 18 

member functions 21 

non-client 383 
EvEraseBkgnd 

TFrame Window member function 206 

TGauge data member 223 

TSlider member function 368 
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EvFindMsg 

TEditSearch member function 186 
EvGetDlgCode 

TButton member function 49, 

TCheckBox member function 60 

TEdit member function 181 

TListView member functions 258 

TSlider member function 368 
EvInitDialog 

TDialog member function 142 
EvInitDialog message 142 
EvInitMenuPopup 

TFrame Window member function 206 
EvKeyDown 

TEdit member function 181 

TKeyboardModeTracker data member 239 

TSlider member function 368 
EvKillFocus 

TEdit member function 181 

TSlider member function 369 
EvLButtonDblClk 

TSlider member function 369 
EvLButtonDown 

TSlider member function 369 
EvLButtonUp 

TSlider member function 369 

TTinyCaption member function 387 
EvMDIActivate 

TMDIChild member function 262 
EvMDICreate 

TMDIClient member function 266 
EvMenuSelect 

TDecoratedFrame member function 137 
EvMouseMove 

TGadgetWindow member function 219 

TSlider member function 369 

TTinyCaption member function 387 
EvNCActivate 

TTinyCaption member function 387 
EvNCCalcSize 

TTinyCaption member function 387 
EvNCDestroy 

TEditView member function 188 

TFindReplaceDialog member function 198 
EvNCHitTest 

TTinyCaption member function 387 



EvNCLButtonDown 

TTinyCaption member function 387 
EvPaint 

and gadgets 220 

TControl member function 85 

TDialog member function 142 

TFrameWindow member function 207 

TSlider member function 370 

TTinyCaption member function 388 
EvParentNotify 

TFrameWindow member function 207 
EvPreProcessMenu 

TDocManager member function 155 
EvQueryDraglcon 

TFrameWindow member function 207 
EvSetFocus 

TFrameWindow member function 207 

TKeyboardModeTracker data member 239 

TSlider member function 370 
EvSetFont 

TDialog member function 142 
EvSetRGBColor 

TChooseColorDialog member function 62 
EvSize 

TDecoratedFrame member function 138 

TFrameWindow member function 207 

TGadgetWindow member function 219 

TLayoutWindow member function 248 

TPreviewPage member function 308 

TSlider member function 370 
EvSyscolorChange 

TGadgetWindow member function 220 
EvSysCommand 

TTinyCaption member function 388 

TWindow member function 423 
EvVbxDispatch 

TVbxEventHandler class 407 
EvWindowPosChanging 

TPreviewPage member function 308 
exception 

TXINVALIDMAINWINDOW 38 

TXInvalidMainWindow 38 

using catch keyword 453 

using try keyword 453 
exception bit flags 456 
exception handler 

precautions 282 
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exception handling 

TStatus 375 

TWindow 413 
exception-unsafe code 435 
exceptions 

error strings 26 

example in PAINT.CPP 229 

message constants 24 

TWindow class 448 

TXCOMPATIBILITY 28 1 

TXCompatibility class 452 

TXGdi class 229 

TXInvalidModule 284 

TXInvalidModule class 287 

TXInvalidWindow class 39 

TXOwl class 453 

TXValidator class 395 
ExcludeClipRect 

TDC member function 98 
ExcludeUpdateRgn 

TDC member function 99 
ExecDialog 

TModule member function 283 
ExecPrintDialog 

TPrinter member function 329 
Execute 

TDialog member function 142 
ExStyle 

TWindow Attr structure 449 
ExtFloodFill 

TDC member function 99 
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LowMemory 

TModule member function 286 
LowValue 

TScrollBarData data member 358 
LParam 

control message parameter 143 
lpCmdLine 

TModule data member 280 
LPtoDP 

TDC member function 113 
LPtoSDP 

TPrintPreviewDC member function 324 
LtBlue 

TColor data member 72 
LtCyan 

TColor data member 72 
LtGray 

TColor data member 72 
LtGreen 

TColor data member 73 
LtMagenta 

TColor data member 73 
LtRed 

TColor data member 73 
LtYellow 

TColor data member 73 



M 

macros 

DEFINE_RESPONSE_TABLE 19 

event handling 18,21 

TButton class 50 

TChooseColorDialog class 62 

TChooseFontDialog class 65 

TClipboardViewer class 72 

TDecoratedFrame class 138 

TDocManager class 157 

TFloatingFrame class 202 

TKeyboardModeTracker class 239 

TTinyCaption class 389 
Magnitude 

TSize member function 364 
main window 

closing 34, 417 

creating 31, 38 

MDI frame 267 

naming 39 

nCmdShow display 32 

status287 
maintaining a view's event table 162 
MainWindow 

variable 39 
MakeWindow 

TModule member function 286 
MapColor 

TDib member function 149 
Maplndex 

TDib member function 149 
MapStatusCodeToString 

TXCompatibility public member function 453 
MapWindowPoints 

TWindow member function 433 
Margin 

TGauge data member 223 
Margin constant 24 1 
Margins 

TGadget data member 212 

TGadgetWindow data member 218 
margins 

for gadgets 21 7 
MaskBlt 

TDC member function 1 14 
MatchTemplate 

TDocManager member function 155 
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matrix 

toolbox arrangement 389 
Max 

TGauge data member 223 

TRange Validator data member 338 

TSlider member function 371 
MAX_RSRC_ERROR_STRING constant 26 
maximum values 

checking for 338 
MaxPage 

TPrintDialog::TData struct data member 322 
MaxWidth 

TListView data member 257 
MB_Xxxx constants 

and document manager 156 

andTdocument 166 
MDIFILE.CPP 

illustrating exceptions 453 
Measureltem 

TControl member function 85 
measurement units, windows 269 
member functions 8, 9 

defining 83, 84 

edge constraints 
determining 1 73 

event handling 21 

obsolete 142 

pointers 
generic 31 
memory 

freeing 182 

managing 280 
Menu 

TWindowAttr structure 450 
menu descriptor 

deleting 204 
menu resource ID 450 
menubar 

number of items 275 
Menultemld 

TDecoratedFrame data member 137 
MENUITEMTEMPLATE structures 285 
menus 

creating 305, 380 

ID constants 23 

loading into memory 285 

managing 270 



MDI windows 267 

system 380 
MergeMenu 

and TMenuDescr 273 

TFrame Window member function 205 
merging menus 273 
message bar 

hint text 276 
message bar implementation 276 
message boxes 

errors 282 
message crackers 457 
message dispatcher 31 
message-handling functions 457 
MessageBox 

TWindow member function 433 
MessageLoop 

TApplication member function 35 
MessageLoopResult 

TApplication member function 37 
messages 375 

exception constants 24 

preprocessing 137, 142 

processing 141,413,418 
incoming 444 

response 207 

sending 

to dialog boxes 143 
Method 

TVbxControl member function 399 
metrics 

layout 26 
Min 

TGauge data member 223 

TRange Validator data member 338 

TSlider member function 371 
minimum values 

checking for 338 
MinPage 

TPrintDialog::TData struct data member 322 
modal dialog boxes 139, 140 
Mode 

TDib member function 145 
mode indicators 376, 377 

borders 377 

spacing 377, 378 
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Modelndicators 

TStatusBar data member 377 
modeless dialog boxes 

creating 349 
Modes 

TKeyboardModeTracker data member 237 
ModifyMenu 

TMenu member function 272 
ModifyWorldTransform 

TDC member function 115 
Module 

TModule data member 281 
modules 31 

DLL stand-in 280 

instance handles 286 

names 287 
MouseEnter 

TGadget member function 213 
MouseLeave 

TGadget member function 213 
MouseMove 

TButtonGadget member function 54 

TGadget member function 214 
MouseOffset 

TSlider member function 371 
Move 

TVbxControl member function 399 
MoveTo 

TDC member function 115 
MoveWindow 

TWindow member function 434 
Msg 

TEventlnfo data member 190 

TResponseTableEntry data member 351 

TXGdi member function 230 

TXWindow member function 448 
multiple document interface 

child menu 267 

child windows 261 
cascading 265 
closing 265 
creating 264, 265 
tiling 265 

client windows 263 
freeing 263 

icons, arranging 265 

main window 267 



MyEdge 

TLayoutConstraint data member 240 

N 

Name 

TDialogAttr data member 144 

TModule member function 287 
named streams 

and TFileDocument 193 
names 

modules 287 
NBits 27 
NCels 

TCelArray data member 57 
nCmdShow 

TApplication data member 32 
NColors 27 
NewFile 

TEditFile member function 183 
NewStringList 

TStringLookup Validator member function 380 
Next 

TWindow member function 434 
NextBand 

TPrintDC member function 317 
NextGadget 

TGadget data member 211 

TGadgetWindow member function 21 7 
NextStream 

TDocument member function 166 

TStream data member 379 
NextView 

TDocument member function 166 
non-client events 383 
Normalize 

TRect member function 341 
Normalized 

TRect member function 341 
NotchCorners 

TButtonGadget data member 52 
notification codes 180 
NotifyCodeTResponseTableEntry data member 

351 
NotifyParent 

TGroupBox data member 231 

THSlider member function 232 

TSlider member function 370 
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TVSlider member function 411 
NotifyViews 

TDocument member function 166 
NotOK 

TView data member 410 
NumCels 

TCelArray member function 56 
NumChars 

TTextGadget member function 382 
NumChildren 

TWindow member function 434 
NumClrs 

TDib member function 146 
numColors 

TDib member function 149 
NumColumns 

TToolBox data member 390 
numeric values 

checking 337, 393 

ranges 
testing for 337 

setting 
maximum /minimum 338 
NumGadgets 

TGadget Window data member 218 
NumGroups 

TMenuDescr enum 276 
NumModelndicators 

TStatusBar data member 377 
NumRows 

TToolBox data member 390 
numScans 

TDib member function 149 



OBJ_REF_ADD 

TGdiObject macro 228 
OBJ_REF_COUNT 

TGdiObject macro 228 
OBJ_REF_DEC 

TGdiObject macro 229 
OBJ_REF_INC 

TGdiObject macro 229 
OBJ_REF_REMOVE 

TGdiObject macro 229 
Object 

TEventlnfo data member 191 



ObjectGroup 

TMenuDescr enum 276 
objects 

windows 446 
ObjectWindows inheritance diagrams 479 
ODADrawEntire 

TControl member function 85 
ODAFocus 

TControl member function 85 
ODASelect 

TControl member function 86 
Offs 

TCelArray data member 57 
Offset 

TCelArray member function 56 

TPoint member function 302 

TRect member function 342 
OffsetBy 

TPoint member function 302 

TRect member function 342 
OffsetClipRgn 

TDC member function 116 
OffsetViewportOrg 

TDC member function 116 

TPrintPreviewDC member function 324 
OffsetWindowOrg 

TDC member function 116 
ofn 

TOpenSaveDialog data member 288 
oixxxx document open enum (constants) 27 
OLE programs 

constants 

compatible 27 
Open 

TDocument member function 166 

TEditFile member function 183 

TFileDocument member function 193 
OpenClipboard 

TClipboard member function 69 

TWindow member function 434 
OPENFILENAME structure 195 
opening a file 

file error 194 
OpenMode 

TStream data member 378 
OpenThisFile 

TFileDocument member function 194 
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operator 

TStatus data member 375 

operator& 

TRect member function 342 

operator+ 

TPoint member function 302 
TRect member function 342 
TSize member function 364 

operator- 

TPoint member function 302 
TRect member function 342 
TSize member function 364 

operator^ 

TStatus data member 375 

operator I 

TRect member function 342 

operator ! 

TPointer member function 305 

operator = 

TCelArray member function 56 
TPointer member function 305 
TRegion member function 347 

operator ~ 

TBitSet member function 46 
TPointer member function 305 

operator != 

TPoint member function 303 
TRect member function 343 
TSize member function 364 

operator&= 

TRect member function 343 

operator += 

TPoint member function 303 
TRect member function 343 
TSize member function 364 

operator-= 

TPoint member function 303 
TRect member function 343 
TSize member function 365 

operator« 

TPoint friend 303 
TRect friend 344, 345 
TResID friend 350, 351 
TSize friend 365 

operator== 

TColor member function 75 
TPoint member function 303 



TRect member function 343 

TRegion member function 347 

TSize member function 364 
operator» 

TPoint friend 303 

TRect friend 344 

TResID friend 350 

TSize friend 365 
operator I = 

TRect member function 343 
operator &= 

TBitSet member function 46 

TRegion member function 348 
operator += 

TBitSet member function 45 

TRegion member function 347 
operator -= 

TBitSet member function 46 

TRegion member function 347 
operator [] 

TCelArray member function 56 
operator A = 

TRegion member function 348 
operator I = 

TBitSet member function 46 

TRegion member function 348 
operator BITMAPINFO() 

TDib member function 149 
operator BITMAPINFOHEADER() 

TDib member function 150 
operator COLORREF() 

TColor member function 75 
operator delete 

TPointer member function 305 
operator FARPROC 

TProcInstance class 333 
operator HANDLE() 

TDib member function 150 
operator HBITMAP() 

TBitmap member function 42 
operator HDC() 

TDC member function 116 
operator HDROP() 

TDropInf o member function 1 71 
operator HINSTANCE 

TModule member function 286 
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operator HMETAFILE() 

TMetaFilePict member function 280 
operator LPSTR() 

TResID member function 350 
operator POINT*() 

TPoint member function 303 
operator TBitmap& 

TCelArray member function 56 
operator TPoint*() 

TRect member function 343 
operator TRgbQuad() 

TDib member function 150 
operators 

TStatusBar class 377 
Options 

TValidator data member 394 
OrgBitmap 

TPaintDC data member 270 
OrgBrush 

TDC data member 134 
OrgFont 

TDC data member 135 
OrgPalette 

TDC data member 135 
OrgPen 

TDC data member 135 
OrgTextBrush 

TDC data member 135 
Origin 

TEditView data member 188 

TListView data member 257 
OtherEdge 

TLayoutConstraint data member 240 
OutStream 

TDocument member function 166 

TFileDocument member function 193 
OvertypeModeChange 

TKeyboardModeTracker member function 239 
OvertypeState 

TKeyboardModeTracker data member 238 
OWLMNCLUDE directory 

and header files 1 1 
_OWLCLASS macro 29 
OWLCMD.CPP 384 
OWLDATA macro 29 



OWLDialog 

default ObjectWindows class 
modeless dialog box 143 
_OWLDLL macro 29 
_OWLFAR macro 29 
JDWLFUNC macro 29 
OWLGet Version member function 30 



PageMagnitude 

TScrollBar data member 354 
PageNum 

TPreviewPage data member 307 
PageSize 

TPrintout data member 332 
pagination 331 

page ranges 331 
Paint 

TBitmapGadget member function 44 

TButtonGadget member function 54 

TGadget data member 214 

TGadgetWindow member function 220 

TGauge data member 224 

TPreviewPage member function 307 

TTextGadget member function 382 

TWindow member function 434 
PAINT.CPP sample program 201 
PaintBorder 

TGadget data member 214 
PaintButton 

TTinyCaption member function 388 
PaintCaption 

TTinyCaption member function 388 
PaintCloseBox 

TTinyCaption member function 389 
PaintGadgets 

TGadgetWindow member function 220 

TMessageBar member function 277 
Paintlnfo structure 434 
painting 

horizontal rulers 233 

slots 233 

windows 207 
painting controls 54 
PaintMaxBox 

TTinyCaption member function 389 
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PaintMinBox 

TTinyCaption member function 389 
PaintRgn 

TDC member function 116 
PaintRuler 

THSlider member function 233 

TSlider member function 370 

TVSlider member function 411 
PaintSlot 

THSlider member function 233 

TSlider member function 370 

TVSlider member function 411 
PaintSysBox 

TTinyCaption member function 389 
PaintThumb 

TSlider member function 370 
PaintToPos 

THSlider member function 233 
Pallndex 

TColor member function 75 
PalRelative 

TColor member function 75 
Param 

TDialogAttr data member 144 

TWindowAttr structure 450 
parameterized subclass 

view and document classes 160 
Parent 

T Window data member 413 
parent windows 413 

handles, returning 284 
passwords 176, 178 
Paste 

TEdit member function 1 78 
PatBlt 

TDC member function 116 
PathToRegion 

TDC member function 117 
pd 

TPrintDialog data member 320 
Percent constant 24 1 
PercentOf 

TEdgeConstraint member function 7 72 

TEdgeOrSizeContraint member function 173 
PerformCreate 

TEditView member function 187 

TMDIChild member function 262 



TVbxControl member function 401 

TWindow member function 435 
pixxxx property attribute constants 28 
Pic 

TPXPicture Validator data member 335 
Picture 

TPXPicture Validator member function 334 
picture strings 

checking 333 

scanning 335 

valid characters 335 
picture validators 333 
Pie 

TDC member function 117 
pixels to twips conversion 407 
placing gadgets 301 
Planes 

TBitmap member function 43 
PlayMetaFile 

TDC member function 118 
PlayMetaFileRecord 

TDC member function 118 
PlgBlt 

TDC member function 1 18 
Pmf 

TResponseTableEntry data member 357 
pointer to a member function 352 

and message dispatchers 465 
pointers 

member functions 31 

transfer buffers 80 
PointSize 

TChooseFontDialog::TData data member 66 
PointToPos 

TSlider member function 370 

TVSlider member function 477 
PolyBezier 

TDC member function 119 
PolyBezierTo 

TDC member function 119 
PolyDraw 

TDC member function 119 
Polygon 

TDC member function 720 
Polyline 

TDC member function 120 
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PolylineTo 

TDC member function 121 
PolyPolygon 

TDC member function 121 
PolyPolyline 

TDC member function 121 
pop-up menus 
creating 305 
Pos 

TSlider data member 371 
Position 

TScrollBarData data member 358 
position 

carets, returning 176, 178 
character, edit control 1 74, 1 76 
current 178,442 
coordinates 355 
list box 249 
moving 356 

text selection 777, 251, 252, 253< 
edit controls 

tab stops in 7 79 
menu (MDI) 267 
relative to origin 49, 76, 84, 174, 231, 248, 336, 

373 
scroll bar 
thumb 354, 360, 361 
range 355 
setting 356 
tracking 356 
scroller 360 

specified by variables 175, 179 
PositionGadget 

TControlBar member function 87 
TGadgetWindow member function 221 
TStatusBar member function 378 
PostDispatchAction 

TApplication member function 35 
PostDocError 

TDocManager member function 155 
PostError 

TDocument member function 166 
PostMessage 

TWindow member function 434 
PosToPoint 

THSlider member function 233 
TSlider member function 370 



TVSlider member function 4 12 
prComplete constant 334 
PreProcessMenu 

TApplication member function 35 
PreProcessMsg 

TControlBar member function 87 

TDecoratedFrame member function 137 

TDialog member function 142 

TFrame Window member function 205 

TMDIChild member function 262 

TMDIClient member function 265 

TWindow member function 435 
prError constant 334 
previewing data 323 
previewing pages 306 
Previous 

TWindow member function 435 
prlnComplete constant 334 
Print 

TPrinter member function 328 
print preview classes 306, 323 
print setup dialog boxes 

controls, initializing 320 

creating 319,321 
PrintDC 

TPreviewPage data member 307 
printer banding flags 332 
printers 327 

changing 327, 329 

configuring 319, 328 

default 
returning 319, 327 
updating 329 

device 
changing 329 
clearing 328 

errors 321 
reporting 328 

IDs 
dialog and control 23 
string constants 25 

settings, initializing 320, 321 

status, determining 25 
PrintExtent 

TPreviewPage data member 307 
printing 319, 330 

device handle 332 
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discontinuing 328, 329 

errors 321 
reporting 328 

events, responding to 320 

jobs, labeling 329, 330, 332 

multiple pages 337 

selected pages 331 

specifications 
copying 319 
initializing 320, 321 
page size 332 
Printout 

TPreviewPage data member 307 
printouts, banding 331, 332 
PrintPage 

TPrintout member function 331 
PrnDC 

TPrintPreviewDC data member 327 
PrnFont 

TPrintPreviewDC data member 327 
Process 

TPXPicture Validator member function 335 
ProcessAppMsg 

TApplication member function 36 
procinstance 333 
program example 

custom cursor 439 
programs 

displaying current state 376, 377 
prompt 

TInputDialog data member 235 
property attributes 

pfxxxx constants 28 
Property enum 

TDocument data member 163 

TView data member 408 
property index 

and TFileDocument 193 
property list 

retrieving handles 428 
PropertyCount 

TDocument member function 166 

TView member function 409 
PropertyFlags 

TDocument member function 167 

TFileDocument member function 193 

TView member function 410 



PropertyName 

TDocument member function 167 

TFileDocument member function 194 

TView member function 410 
protected constructor 

TStream class 379 
protected data member 

TFileDocument class 194 
protected data members 

TApplication class 37 

TButton class 49 

TCelArray class 57 

TChooseColor Dialog class 61 

TChooseFontDialog class 64 

TClipboard class 70 

TClipboardViewer class 72 

TCommonDialog class 82 

TDecoratedFrame class 137 

TDocument class 168 

TEdit class 179 

TEditView class 188 

TFilter Validator class 197 

TFindReplaceDialog class 198 

TFrame Window class 206 

TLayoutWindow class 248 

TListView class 257 

TMenu class 273 

TModule class 287 

TOpenSaveDialog class 288 

TPreviewPage class 307 

TPrintDialog class 320 

TPrinter class 328 

TPrintout class 332 

TPrintPreviewDC class 327 

TPXPicture Validator class 335 

TRange Validator class 338 

TSlider class 371 

TStatusBar class 377 

TStream class 379 

TStringLookup Validator class 380 

TTinyCaption class 384 

TValidator class 394 

TView class 410 

TWindow class 445 
protected member functions 

TApplication class 38 

TBitmapGadget class 44 
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TButton class 49 
TCheckBox class 60 
TChooseColorDialog class 62 
TChooseFontDialog class 64 
TComboBox class 80 
TCommonDialog class 83 
TControl class 85 
TDecoratedFrame class 137 
TDecoratedMDIFrame class 138 
TDialog class 143 
TDocManager class 156 
TDocTemplate class 160 
TDocument class 168 
TEdit class 179 
TEditFile class 184 
TEditView class 188 
TEventHandler class 190 
TFileDocument class 194 
TFindDialog class 197 
TFindReplaceDialog class 199 
TFrame Window class 206 
TGroupBox class 232 
TInputDialog class 236 
TLayoutWindow class 248 
TListBox class 254 
TListView class 257 
TMDIChild class 262 
TMDIClient class 265 
TMDIFrame class 268 
TOpenSaveDialog 289 
TPreviewPage class 308 
TPrinter class 329 
TPrintPreviewDC class 327 
TPXPicture Validator class 335 
TRadioButton class 337 
TReplaceDialog class 349 
TScrollBar class 357 
TSlider class 368 
TStatic class 375 
TStatusBar class 378 
TTinyCaption class 385 
TVbxControl class 401 
TVbxEventHandler class 407 
TView class 410 
TWindow class 446 
prXxxx constants 300 



Ps 

TPaintDC data member 292 
Ptln 

TGadget data member 214 
PtVisible 

TDC member function 121 
public data member 

TListView class 256 
public data members 

TApplication class 31 

TButton class 49 

TCheckBox class 58 

TChooseColorDialog: :TData struct 63 

TChooseFontDialog: :TData struct 65 

TClipboard class 67 

TComboBox class 76 

TComboBoxData class 81 

TDialog class 140 

TDocManager class 153 

TDocument class 1 63 

TEditFile class 182 

TEditSearch class 185 

TEventlnfo class 190 

TFloatingFrame class 20 1 

TFrame Window class 204 

TGroupBox class 231 

TInputDialog class 235 

TLayoutConstraint structure 240 

TLayoutMetrics class 242 

TListBoxData structure 254 

TMDIClient class 263 

TMDIFrame class 267 

TModule class 280 

TOpenSaveDialog::TData 290 

TPrintDialog::TData struct 321 

TResponseTableEntry class 351 

TScrollBar class 354 

TScrollBarData structure 358 

TStatic class 373 

TStatus class 375 

TStatusBar class 376 

TStream class 378 

TView class 408 

TWindow class 413 

TWindow Attr structure 449 
public destructor 

TStream class 378 
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public member functions 
TApplication class 33 
TBitmapGadget class 44 
TBitSet class 45 
TCelArray class 56 
TCharSet class 58 
TCheckBox class 59 
TChooseColor Dialog class 61 
TClipboard class 67 
TClipboardViewer class 71 
TComboBox class 77 
TComboBoxData class 81 
TCommonDialog class 82 
TControl class 84 
TDecoratedFrame class 136 
TDialog class 140 
TDocManager class 153 
TDocTemplate class 157 
TDocTemplateT class 161 
TDocument class 164 
TEdgeConstraint structure 171 
TEdgeOrSizeConstraint structure 1 72 
TEdit class 174 
TEditFile class 183 
TEditSearch class 186 
TEditView class 187 
TFileDocument class 192 
TFileOpenDialog class 195 
TFileSaveDialog class 196 
TFilter Validator class 196 
TFindReplaceDialog::TData struct 199 
TFindReplaceDialog class 198 
TFrame Window class 204 
TGroupBox class 231 
TInputDialog class 236 
TLay out Window class 247 
TListBox class 249 
TListBoxData structure 255 
TListView class 256 
TLookup Validator class 260 
TMDIChild class 261 
TMDIClient class 263 
TMDIFrame class 268 
TMenu class 271 
TModule class 282 
TOpenSaveDialog class 288 
TPointer class 304 



TPopupMenu class 305 

TPreviewPage class 307 

TPrintDialog::TData struct 322 

TPrintDialog class 319 

TPrinter class 328 

TPrinterAbortDlg class 330 

TPrintout class 330 

TPrintPreviewDC class 324 

TPXPicture Validator class 334 

TRange Validator class 337 

TScrollBar class 355 

TScroller class 360 

TSlider class 367 

TStatic class 374 

TStatusBar class 376 

TStream class 379 

TStringLookup Validator class 380 

TValidator class 392 

TVbxControl class 397 

TView class 409 

TWindow class 415 

TWindowView class 451 
pull-down menu items 

defining 276 
PumpWaitingMessages 

TApplication member function 36 
pure virtual 

Create function 417 

registration GetClassName function 446 
push buttons 48 

default 48 

Q 

Query Abort 

TPrintDC member function 317 
QueryCreate 

TClipboard member function 69 
QueryEscSupport 

TPrintDC member function 317 
QueryLink 

TClipboard member function 69 
QueryThrow 

TApplication member function 36 
Query Views 

TDocument member function 167 
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radio buttons 336 
Range 

TSlider data member 372 
range validators 337 
range values 

converting to scroll values 26 
ranges 

numeric values 
testing for 337 
Read 

TDib member function 15 1 

TEditFile member function 184 
RealizePalette 

TDC member function 121 
ReceiveMessage 

TWindow member function 435 
Rectangle 

TDC member function 122 
RectVisible 

TDC member function 122 
Red 

TColor member function 75 
RedrawWindow 

TWindow member function 435 
Ref Add 

TGdiObject member function 226 
RefCount 

TGdiObject member function 226 
RefDec 

TGdiObject member functions 226 
RefFind 

TGdiObject member function 226 
Refine 

TGdiObject member function 227 
RefRemove 

TGdiObject member function 227 
Refresh 

TVbxControl member function 400 
RefTemplate 

TDocManager member function 156 
Register 

TWindow member function 435 
RegisterClipboardFormat 

TClipboard member function 70 
RegisterHotKey 

TWindow member function 435 



registration 

Windows 435 
relational databases 

validity checking 333 
Relationship 

TLayoutConstraint data member 240 
RelWin 

TLayoutConstraint data member 240 
Remove 

TDocument::List member function 169 

TGadgetWindow member function 217 
RemoveChild 

TWindow member function 446 
RemoveChildLayoutMetrics 

TLayoutWindow member function 247 
Removed 

TControlGadget member function 88 

TGadget member function 214 
Removeltem 

TVbxControl member function 400 
RemoveMenu 

TMenu member function 273 
RemoveProp 

TWindow member function 436 
removing a property 436 
ReOrg 

TPrintPreviewDC member function 324 
ReplaceWith 

TEditFile member function 184 

TFindReplaceDialog::TData member function 

200 
ReportError 

TPrinter member function 328 
ReScale 

TPrintPreviewDC member function 324 
ResetDC 

TDC member function 122 
ResetSelections 

TListBoxData member function 255 
ResizePalette 

TPalette member function 296 
resource files 

described 15 
resource ID 

TXOwl 454 
resource IDs 

retrieving default 142 
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ResourceldToString 

TXOwl public member function 454 
resources 

callback functions and 286 

finding 282, 283 

handles, returning 285 

loading 286 
into memory 282, 285 

Windows applications 286 

size, returning 286 
response functions 457 
response table 

TFloatingFrame class 202 
response table entries 351 

TWindowView 452 
Response table entry 

TListView member functions 259 
response table macro 

and signature template 465 
response table macros 

for VBX events 404 
response tables 

and document manager 152 

declaring 18 

defining 19,21 

TButton class 50 

TCheckBox class 61 

TChooseColorDialog class 62 

TChooseFontDialog class 65 

TClipboardViewer class 72 

TCommonDialog class 83 

TControl class 86 

TControlGadget 89 

TDecoratedFrame class 138 

TDecoratedMDIFrame class 139 

TDialog class 144 

TDocManager class 157 

TEdit class 181 

TEditFile class 185 

TEditSearch class 186 

TFrame Window class 208 

TKeyboardModeTracker class 239 

TLayoutWindow class 248 

TMDIChild class 263 

TMDIClient class 266 

TMDIFrame class 268 

TOpenSaveDialog class 290 



TPreviewPage 308 

TPrintDialog class 320 

TRadioButton class 337 

TSlider class 372 

TTinyCaption class 389 

TVbxControl 402 

TVbxEventHandler 407 

TWindow class 447 
RestoreBitmap 

TMemoryDC 269 
RestoreBrush 

TDC member function 122 
RestoreDC 

TDC member function 122 
RestoreFont 

TDC member function 122 

TPrintPreviewDC member function 324 
RestoreMemory 

TModule member function 286 
RestoreMenu 

TFrameWindow member function 205 
RestoreObjects 

TDC member function 122 

TMemoryDC 269 
RestorePalette 

TDC member function 123 
RestorePen 

TDC member function 123 
RestoreTextBrush 

TDC member function 123 
ResumeThrow 

TApplication member function 36 
retrieving information about events 190 
returning a pointer to a TWindow 428 
Revert 

TDocument member function 167 

TFileDocument member function 194 
Rgb 

TColor member function 75 
RightOf 

TEdgeConstraint member function 7 72 
RootDocument 

TDocument member function 167 
RoundRect 

TDC member function 123 
Run 

TApplication member function 36 
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s 

SameAs 

TEdgeConstraint member function ) 72 

TEdgeOrSizeContraint member function 7 73 
sample class entry 8 
sample programs 

caption bars 384 

sliders 366 

VALID ATE.CPP 391 
Save 

TEditFile member function 1 84 
SaveAs 

TEditFile member function 184 
SaveDC 

TDC member function 123 
SB_ scroll bar constants 360, 361 
SB_BOTTOM constant 356 
SB_LINEDOWN constant 356 
SB_LINEUP constant 356 
SB_PAGEDOWN constant 356 
SB_PAGEUP constant 356 
SB_THUMBPOSITION constant 356 
SB_THUMBTRACK constant 356 
SB_TOP constant 357 
SBBottom 

TScrollBar member function 355 
SBLineDown 

TScrollBar member function 356 
SBLineUp 

TScrollBar member function 356 
SBPageDown 

TScrollBar member function 356 
SBPageUp 

TScrollBar member function 356 
SBS_HORZ constant 355 
SBS_VERT constant 355 
SBThumbPosition 

TScrollBar member function 356 
SBThumbTrack 

TScrollBar member function 356 
SBTop 

TScrollBar member function 356 
Scale ViewportExt 

TDC member function 123 

TPrintPreviewDC member function 325 
Scale WindowExt 

TDC member function 123 



TPrintPreviewDC member function 325 
Scan 

TPXPicture Validator member function 335 
scanning picture formats 335 
scope resolution operator 

Windows API calls 3 
screen device 

logical point conversions 324, 325 
screen resolution 

layout units and 24 1 
ScreenToClient 

TWindow member function 436 
Scroll 

TEdit member function 1 78 
scroll bars 354, 358 
position 

line down 356 
thumb 354, 356, 360, 361 
returning 358 
range 

getting 355 
setting 361 
thumb 354, 355 
sliders vs. 365 
transferring 357 
TScrollBarData 358 
warning 354 
scroll values 

converting to range values 26 
ScrollBy 

TScroller member function 361 
ScrollDC 

TDC member function 124 
Scroller 

TWindow data member 413 
scroller 413 
scrolling windows 
page size 

setting 360 
scroll bars 

horizontal 360 
position 360 
range, setting 36 1 
vertical 36 1 
units 

setting 361 
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ScrollLockModeChange 

TKeyboardModeTracker member function 239 
ScrollLockState 

TKeyboardModeTracker data member 238 
ScrollTo 

TScroller member function 361 
ScrollWindow 

TWindow member function 436 
ScrollWindowEx 

TWindow member function 436 
SDJNPUTDIALOG constant 236 
SDPtoLP 

TPrintPreviewDC member function 325 
search 185 

case-sensitive or case-insensitive 1 78 

list box 249 
Search, TEdit member function 1 78 
SearchCmd 

TEditSearch data member 185 
SearchData 

TEditSearch data member 185 
SearchDialog 

TEditSearch data member 185 
searching for 

specific strings 260, 380 

specified characters 335, 336 
SelCount 

TListBoxData data member 254 
Select 

TListBoxData member function 255 
select and restore functions 324, 325 
SelectAnySave 

TDocManager member function 156 
SelectClipPath 

TDC member function 124 
SelectClipRgn 

TDC member function 125 
SelectDocType 

TDocManager member function 156 
Selectlmage 

TBitmapGadget member function 44 
Selection 

TComboBoxData data member 81 
selection 230 

adding strings 254, 255 

colors 61 

data transfer 254, 255 



fonts 63 

number of items 254 

removing strings 254, 255 

text 177, 179 
SelectionChanged 

TGroupBox member function 231 
SelectObject 

TDC member function 125 

TMemoryDC 270 

TPrintPreviewDC member function 325 
SelectSave 

TDocTemplate member function 159 
SelectStockObject 

TDC member function 125 

TPrintPreviewDC member function 325 
SelectString 

TListBoxData member function 255 
SelectViewType 

TDocManager member function 157 
Sellndex 

TComboBoxData data member 81 
SelStrings 

TListBoxData data member 254 
SendDlgltemMessage 

TWindow member function 437 
SendDlgltemMsg 

TDialog member function 143 
sending messages 416 
SendMessage 

TWindow member function 437 
SendNotification 

TWindow member function 437 
separators 

width and height 362 
Set 

TEdgeConstraint member function 1 72 

TRect member function 344 
SetAbortProc 

TPrintDC member function 317 
SetActiveWindow 

TWindow member function 437 
SetBitmapBits 

TBitmap member function 43 
SetBitmapDimension 

TBitmap member function 43 
SetBkColor 

TDC member function 125 
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TPrintPreviewDC member function 326 
SetBkgndColor 

TWindow member function 437 
SetBkMode 

TDC member function 126 
SetBorders 

TGadget data member 211 
SetBorderStyle 

TGadget data member 211 
SetBounds 

TBitmapGadget member function 44 

TButtonGadget member function 55 

TControlGadget member function 88 

TGadget data member 21 1 
SetBoundsRect 

TDC member function 126 
SetBrushOrg 

TDC member function 126 
SetButtonState 

TButtonGadget member function 52 
SetButtonType 

TButtonGadget member function 52 
SetCaption 

TDialog member function 143 

TWindow member function 438 
SetCaretBlinkTime 

TWindow member function 438 
SetCaretlndex 

TListBox member function 252 
SetCaretPos 

TWindow member function 438 
SetCelSize 

TCelArray member function 56 
SetCheck 

TCheckBox member function 59 
SetChildLayoutMetrics 

TLay out Window member function 247 
SetClassLong 

TWindow member function 438 
SetClassWord 

TWindow member function 438 
SetClientWindow 

TFrame Window member function 205 
SetClipboardData 

TClipboard member function 70 
SetClipboardViewer 

TClipboard member function 70 



SetColor 

TDib member function 150 
SetColumnWidth 

TListBox member function 252 
SetCopyCount 

TPrintDC member function 318 
SetCursor 

TWindow member function 438 
SetDefaultExt 

TDocTemplate member function 159 
SetDefaultld 

TDialog member function 143 
SetDevMode 

TPrintDialog::TData member function 323 
SetDevNames 

TPrintDialog::TData member function 323 
SetDIBits 

TDC member function 126 
SetDIBitsToDevice 

TDC member function 127 
SetDirection 

TGadgetWindow member function 217 

TToolBox data member 390 
SetDirectory 

TDocTemplate member function 159 
SetDlgltem 

TWindow member function 439 
SetDlgltemText 

TWindow member function 439 
SetDocManager 

T Application member function 36 

TDocTemplate member function 159 
SetDocmanager 

TDocument member function 167 
SetDocPath 

TDocument member function 167 
SetDocTitle 

TEditView member function 188 

TListView member function 257 

TView member function 410 

TWindow member function 439 

TWindow View member function 452 
SetEditSel 

TComboBox member function 79 
SetEmpty 

TRect member function 344 
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SetEnabled 

TGadget data member 211 
SetExtendedUI 

TComboBox member function 79 
SetExtent 

TListView member functions 259 
SetFileFilter 

TDocTemplate member function 159 
SetFileName 

TEditFile member function 184 
SetFilter 

TOpenSaveDialog::TData struct 292 
SetFlag 

TDocTemplate member function 159 

TWindow member function 439 
SetHandle 

TEdit member function 178 
SetHintCommand 

TGadget Window member function 217 
SetHintMode 

TGadget Window member function 217 
SetHintText 

TMessageBar member function 276 
SetHorizontalExtent 

TListBox member function 252 
Setlcon 

TFrameWindow member function 206 
Setlndex 

TDib member function 150 
Setlnstance 

TModule member function 286 
SetltemData 

TComboBox member function 79 

TListBox member function 252 
SetltemHeight 

TComboBox member function 79 

TListBox member function 252 
SetLed 

TGauge data member 222 
SetMain Window 

TApplication member function 36 
SetMain WinParams 

TApplication member function 37 
SetMapMode 

TDC member function 127 

TPrintPreviewDC member function 326 



SetMapperFlags 

TDC member function 127 
SetMargins 

TFloatingFrame member functions 201 

TGadget data member 21 1 

TGadgetWindow member function 217 
SetMenu 

TMDIFrame member function 268 

TWindow member function 439 
SetMenuDescr 

TFrameWindow member function 206 
SetMenuItemBitmaps 

TMenu member function 273 
SetMiterLim.it 

TDC member function 128 
SetModelndicator 

TStatusBar member function 377 
SetModule 

TWindow member function 439 
SetNotchCorners 

TButtonGadget member function 52 
SetNumCels 

TCelArray member function 56 
SetOffset 

TCelArray member function 56 
SetOpenMode 

TDocument member function 167 
SetOption * 

TValidator member function 393 
SetPageNumber 

TPreviewPage member function 307 
SetPageSize 

TScroller member function 360 
SetPaletteEntries 

TPalette member function 296 
SetPaletteEntry 

TPalette member function 296 
SetParent 

TWindow member function 440 
SetPasswordChar 

TEdit member function 1 78 
SetPixel 

TDC member function 128 
SetPolyFillMode 

TDC member function 128 
SetPosition 

TScrollBar member function 357 
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TSlider member function 368 
SetPrinter 

TPrinter member function 329 
SetPrintParams 

TPrintout member function 331 
SetProp 

TVbxControl member function 400, 401 

TWindow member function 440 
SetProperty 

TDocument member function 168 

TFileDocument member function 194 

TView member function 410 
SetRange 

TGauge data member 222 

TScrollBar member function 357 

TScroller member function 36 1 

TSlider member function 368 
SetReadOnly 

TEdit member function 1 78 
SetRect 

TEdit member function 1 78 
SetRectNP 

TEdit member function 1 78 
SetRectRgn 

TRegion member function 348 
SetResourceHandler 

TModule member function 286 
SetRGBColor 

TChooseColor Dialog member function 61 
SetRGBMsgld 

TChooseColorDialog data member 62 
SetROP2 

TDC member function 128 
SetRuler 

TSlider member function 368 
SetSBar Range 

TScroller member function 361 
SetScrollPos 

TWindow member function 440 
SetScrollRange 

TWindow member function 440 
SetSel 

TListBox member function 252 
SetSelection 

TEdit member function 179 
SetSellndex 

TComboBox member function 79 



TListBox member function 252 
SetSellndexes 

TListBox member function 252 
SetSelltemRange 

TListBox member function 253 
SetSelString 

TComboBox member function 79 

TListBox member function 253 
SetSelStrings 

TListBox member function 253 
SetShqdowStyle 

TButtonGadget member function 52 
SetShrinkWrap 

TGadget member function 21 1 

TGadget Window member function 217 
SetSize 

TGadget data member 21 1 
SetSpacing 

TStatusBar member function 377 
SetState 

TCheckBox member function 59 
SetStretchBltMode 

TDC member function 129 
SetStyle 

TCheckBox member function 59 
SetSysModalWindow 

TWindow member function 440 
SetSystemPaletteUse 

TDC member function 129 
SetTabStops 

TEdit member function 1 79 

TListBox member function 253 
SetTemplate 

TDocument member function 168 
SetText 

TComboBox member function 80 

TMessageBar member function 276 

TStatic member function 374 

TTextGadget member function 381 
SetTextAlign 

TDC member function 129 
SetTextCharacterExtra 

TDC member function 1 29 
SetTextColor 

TDC member function 130 

TPrintPreviewDC member function 326 
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SetTextJustification 

TDC member function 130 

SetTimer 

TWindow member function 44 1 

setting bits 45 

SetTitle 

TDocument member function 168 

SetTopIndex 

TListBox member function 253 

SetTransferBuffer 

TWindow member function 441 

SetUnits 

TScroller member function 361 

Setup 

TPrinter member function 328 

SetupThurnbRgn 

TSlider member function 371 

SetupWindow 

TButton member function 50 
TClipboard Viewer member function 71 
TComboBox member function 80 
TCommonDialog member function 83 
TDecoratedFrame member function 138 
TDialog member function 144 
TEdit member function 181 
TEditFile member function 184 
TEditSearch member function 186 
TFrame Window member function 207 
TInputDialog member function 236 
TPrinter AbortDlg member function 330 
TScrollBar member function 357 
TSlider member function 371 
TWindow member function 447 

SetValue 

TGauge data member 222 

SetViewMenu 

TView member function 410 

SetViewportExt 

TDC member function 130 
TPrintPreviewDC member function 326 

SetViewportOrg 

TDC member function 130 
TPrintPreviewDC member function 326 

Set Window 

TScroller member function 361 

SetWindowExt 

TDC member function 131 



TPrintPreviewDC member function 326 
SetWindowLong 

TWindow member function 44 1 
SetWindowOrg 

TDC member function 131 
SetWindowPlacement 

TWindow member function 44 1 
SetWindowPos 

TWindow member function 44 1 
SetWindowText 

TWindow member function 442 
SetWindowWord 

TWindow member function 442 
SefWordBreakProc 

TEdit member function 1 79 
SetWorldTransform 

TDC member function 131 
ShareViMsgld 

TOpenSaveDialog data member 288 
Share Violation 

TOpenSaveDialog member function 289 
ShouldDelete 

TCelArray data member 57 

TDC data member 135 

TGdiObject data member 227 

TMenu data member 273 
Show 

TWindow member function 442 
ShowCaret 

TWindow member function 442 
showCmd constants 442 
ShowList 

TComboBox member function 80 
ShowOwnedPopups 

TWindow member function 442 
ShowScrollBar 

TWindow member function 443 
ShowWindow 

TWindow member function 443 
shrink-wrapping for gadgets 215 
shrinkToClient 

in TFrame Window's constructor 204 
shrinktoClient 

and notify parent window event 207 
ShrinkWrapHeight 

TGadget data member 212 

TGadgetWindow data member 219 
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ShrinkWrap Width 

TGadget data member 21 2 
TGadgetWindow data member 219 
shxxxx document sharing enum (constants) 30 
signature abbreviations 
and data types 466 
used by member functions 466 
signature template 

used in response table macro 465 
Size 

TDib member function 750 
TRect member function 344 
size constraints, creating windows 24 1 
SizeMax 

TChooseFontDialog::TData data member 66 
SizeMin 

TChooseFontDialog::TData data member 66 
SizeOfResource 

TModule member function 286 
SkipToComma 

TPXPicture Validator member function 336 
slicing bitmaps 55 
SlideDc 

TSlider data member 372 
SLIDER.CPP 366 
SLIDER.CPP sample program 367 
sliders 

background, erasing 368 
background colors 370 

storing 371 
description of 365 
horizontal 232 
objects 

constructing 367 
destructing 367 
painting 368, 370 
entire 370 
rulers in 370 
thumbs 370 
recalculating sizes 370 
resource ID 

thumb knob 372 
thumb positions 

aligning with tick positions 366, 368 
current position 367 
moving 368, 371 
present range 367 



returning 372 
setting 369 
snapping 371, 372 
translating 370, 371 

thumb shape, defining 371, 372 

tick positions and 366 
setting gaps 372 

vertical 411 
SlideThumb 

TSlider member function 371 
Sliding 

TSlider data member 372 
SlotThick 

TSlider data member 372 
Snap 

TSlider data member 372 
snapping 371, 372 
SnapPos 

TSlider member function 371 
sounds, beep 180 
Spacing 

TStatusBar data member 378 
SS_LEFT constant 374 
StartDoc 

TPrintDC member function 318 
StartScan 

TDib member function 150 
static controls 

registration class name 375 

resources and associating with objects 374 

text length 373 
StaticName 

TEditView member function 188 

TListView member function 257 

TWindowView member function 452 
Status 

TModule data member 281 

TWindow data member 413 
status, main window 28 1 
status bars 375 

borders 377 

creating 376 

inserting text in 376, 377 

spacing items in 377, 378 
status code 

TXCompatibility constructor 453 
status lines 136 
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Stockld 

TBrush data member 46 
Stocks [] 

TBrush data member 47 

TFont data member 202 

TPalette data member 293 

TPen data member 299 
streaming 

TFileDocument 193 

TInStream 236 

TOutStream 292 
StreamName 

TStream data member 378 
streams 

constructing 

document modes 27 

open 193 
StretchBlt 

TDC member function 131 
StretchDIBits 

TDC member function 132 
string-lookup validators 379 
string message 

TXOwl 454 
Strings 

TComboBoxData data member 81 

TListBoxData data member 254 

TStringLookup Validator data member 380 
strings 

adding to 
list boxes 249, 254, 255 

checking validity of 379 

comparing 196, 249, 260 
picture 333 

concatenating 255 

deleting 249 

finding 255 

getting 257 

ID constants 23 
list view 25 

inserting 252 

length 373 
getting 251 

loading into memory 286 

searching for 260, 380 
StrokeAndFillPath 

TDC member function 132 



StrokePath 

TDC member function 132 
structs 

BANDINFOSTRUCT 40 

DOCINFO 319 

TBandInfo40 
structures 

TWindowAttr 449 
Style 

TChooseFontDialog-.TData data member 66 

TWindowAttr structure 450 
styles 

button 49 

combo boxes 76 

edit controls 174 

list box 248 

scroll bars 354 
SubclassWindowFunction 

TWindow member function 443 
SuspendThrow 

TApplication member function 37 
SyncFont 

TPrintPreviewDC member function 327 
synchronizing functions 324, 327 
SyntaxCheck 

TPXPicture Validator member function 336 
SysColorChange 

TBitmapGadget member function 44 

TButtonGadget member function 52 
SyscolorChange 

TGadget member function 212 
system menu, creating 380 



TResponseTableEntry member function 352 
tab stops, creating 231 
tab stops, edit controls, setting 179 
TabbedTextOut 

TDC member function 132 
TActionFunc typedef 30 
TActionMemFunc typedef 30 
Tag 

TDocument data member 163 

TView data member 408 
TAlign 

TTextGadget data member 381 
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TAnyDispatcher typedef 31 
TAnyPMF typedef 31 
TApplication 

inheritance diagram 479 
TApplication class 31 
constructors 32, 33 
data members 
protected 37 
public 31 
destructor 33 
member functions 
protected 38 
public 33 
TAutoDelete 

TDC data member 92 
TGdiObject data member 225 
TBandlnfo 
struct 40 
TBButtonGadget 

inheritance diagram 482 
TBitMap 

inheritance diagram 480 
TBitmap 

constructors 40 
member functions 
GetBitmapBits 42 
GetBitmapDimension 42 
GetObject 42 
HandleCreate 43 
operator HBITMAP() 42 
SetBitmapBits 43 
SetBitmapDimension 43 
ToClipboard 43 
related operator 
«42 
TBitmap* Bitmap 

TCelArray data member 57 
TBitmap member functions 
BitsPixel 42 
Height 42 
Planes 43 
Width 43 
TBitMapGadget 

inheritance diagram 480 
TBitmapGadget class 43 
constructor 44 
destructor 44 



member functions 
protected 44 
public 44 
TBitSet class 45 
constructors 45 
member functions 
public 45 
TBorders struct 

TGadget data member 208 
TBorderStyle 

TGadget data member 209, 212 
TBrush 46 

constructors 47 
data members 
Stockld 46 
Stocks[] 47 
member functions 
GetObject 48 
GetStock 48 
operator HBRUSH() 48 
UnrealizeObject 48 
TButton 

inheritance diagram 481 
TButton class 48 
constructors 49 
data members 
protected 49 
public 49 
macros 50 

member functions, protected 49 
response table 50 
TCelArray class 55 
constructors 55 
data members, protected 57 
destructors 55 
member functions, public 56 
TCEnabled 

TTinyCaption data member 384 
TCharSet class 57 
constructors 57 
member functions 
public 58 
TCheckBox - 

inheritance diagram 483 
TCheckBox class 58 
constructors 58 
data members, public 58 
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member functions 
protected 60 
public 59 

response table 61 
TChooseColorDialog 

inheritance diagram 484 
TChooseColorDialog class 61 

constructor 61 

data members, protected 61 

macro 62 

member functions 
protected 62 
public 61 

response table 62 

TData structure 62 
TChooseFontDialog 

inheritance diagram 486 
TChooseFontDialog: :TData struct 

data members 
public 65 
TChooseFontDialog class 63 

constructor 64 

data members, protected 64 

macro 65 

member functions, protected 64 

response table 65 

TData structure 65 
TClientDC 

constructor 67 
TClipboard class 67 

constructor 70 

data members 
protected 70 
public 67 

destructor 70 

member functions, public 67 

operator BOOL 69 
TClipboardViewer 

inheritance diagram 487 
TClipboardViewer class 71 

constructor 71 

data members, protected 72 

macro 72 

member functions, public 71 

response table 72 
TColor 

class 72 



constructors 73 
TColor data members 

Black 72 

Gray 72 

LtBlue 72 

LtCyan 72 

LtGray 72 

LtGreen 73 

LtMagenta 73 

LtRed 73 

LtYellow 73 

Value 75 

White 73 
TColor member functions 

Blue 74 

Flags 74 

Green 74 

Index 75 

operator== 75 

operator COLORREF() 75 

Pallndex 75 

PalRelative 75 

Red 75 

Rgb 75 
TComboBox 

inheritance diagram 488 
TComboBox class 76 

constructors 76, 77 

data members, public 76 

member functions 
protected 80 
public 77 
TComboBoxData 

inheritance diagram 490 
TComboBoxData class 81 

constructor 81 

data members, public 81 

destructor 81 

member functions, public 81 
TCommandEnabler 422 
TCommmonDialog 

inheritance diagram 492 
TCommonDialog class 82 

constructor 82 

data members, protected 82 

member functions 
protected 83 
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public 82 

response table 83 
TCondFunc type 83 
TCondMemFunc typedef 84 
TControl 

inheritance diagram 493 
TControl class 84 

constructors 84 

member functions 
protected 85 
public 84 

response table 86 
TControlBar 

inheritance diagram 494 
TControlGadget 

inheritance diagram 495 
TControlGadget class 87 

constructors 88 

destructor 88 

response tables 89 
TCreatedDC 

constructors 89 

destructor 89 

member function 90 
TCursor 

constructors 90 

destructor 91 

member functions 
Getlconlnfo 91 
HCURSOR[] 91 
td transfer function constants 

TComboBox::Transfer and 80 
TData structure 

TChooseColorDialog class 62 

TChooseFontDialog class 65 

TPrintDialog class 320 
TDC 

constructors 92, 135 

destructor 93 
TDC data members 

Handle 134 

OrgBrush 134 

OrgFont 135 

OrgPalette 135 

OrgPen 135 

OrgTextBrush 135 

ShouldDelete 135 



TAutoDelete 92 
TDC member functions 
AngleArc 93 
Arc 93 
BeginPath 93 
BitBlt 94 
Chord 94 
CloseFigure 95 
DPtoLP 95 
DrawFocusRect 95 
Drawlcon 95 
DrawText 95 
Ellipse 97 
EndPath 97 
EnumFontFamilies 97 
EnumFonts 97 
EnumMetaFile 98 
EnumObjects 98 
ExcludeClipRect 98 
ExcludeUpdateRgn 99 
ExtFloodFill 99 
ExtTextOut 99 
FillPath 100 
FillRect 100 
FillRgn 100 
FlattenPath 101 
FloodFill 101 
FrameRect 101 
FrameRgn 101 
GetAspectRatioFilter 101 
GetAttributeHDC 136 
GetBkColor 101 
GetBkMode 101 
GetBoundsRect 102 
GetBrushOrg 102 
GetCharABCWidths 102 
GetChar Width 102 
GetClipBox 103 
GetClipRgn 103 
GetCurrentObject 103 
GetCurrentPosition 103 
GetDCOrg 103 
GetDeviceCaps 104 
GetDIBits 104 
GetFontData 104 
GetGlyphOutline 110 
GetHDC 136 
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GetKerningPairs 104 
GetMapMode 105 
GetNearestColor 106 
GetOutlineTextMetrics 106 
GetPixel 106 
GetPolyFillMode 106 
GetROP2() 106 
GetStretchBltMode 106 
GetSystemPaletteEntries 107 
GetSystemPaletteUse 107 
GetTabbedTextExtent 107 
GetTextAlign 107 
GetTextCharacterExtra 129 
GetTextColor 109 
GetTextExtent 109 
GetTextFace 109 
GetTextMetrics 110 
GetViewportExt 110 
GetViewportOrg 111 
GetWindowExt 1 1 1 
GetWindowOrg 111 
GrayString 111 
Init 136 

IntersectClipRect 112 
InvertRect 112 
InvertRgn 112 
LineDDA 1 13 
LineTo 113 
LPtoDP 113 
MaskBlt 1 14 

Modify WorldTransform 115 
MoveTo 7 15 
OffsetClipRgn 1 16 
OffsetViewportOrg 116 
OffsetWindowOrg 116 
operator HDC() 116 
PaintRgn 116 
PatBlt 1 16 
PathToRegion 117 
Pie 117 

PlayMetaFile 118 
PlayMetaFileRecord 118 
PlgBlt 1 18 
PolyBezier 119 
PolyBezierTo 119 
PolyDraw 119 
Polygon 120 



Polyline 120 
PolylineTo 121 
PolyPolygon 121 
PolyPolyline 121 
PtVisible 121 
RealizePalette 121 
Rectangle 122 
RectVisible 122 
ResetDC 122 
RestoreBrush 122 
RestoreDC 122 
RestoreFont 122 
RestoreObjects 122 
RestorePalette 123 
RestorePen 123 
RestoreTextBrush 123 
RoundRect 123 
SaveDC 123 
Scale ViewportExt 123 
ScaleWindowExt 123 
ScrollDC 124 
SelectClipPath 124 
SelectClipRgn 725 
SelectObject 725 
SelectStockObject 725 
SetBkColor 725 
SetBkMode 725 
SetBoundsRect 725 
SetBrushOrg 725 
SetDIBits 725 
SetDIBitsToDevice 727 
SetMapMode 727 
SetMapperFlags 727 
SetMiterLimit 725 
SetPixel 725 
SetPolyFillMode 725 
SetROP2 725 
SetStretchBltMode 129 
SetSystemPaletteUse 129 
SetTextAlign 725 
SetTextCharacterExtra 129 
SetTextColor 730 
SetText Justification 130 
SetViewportExt 730 
SetViewportOrg 730 
SetWindowExt 737 
SetWindowOrg 737 
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SetWorldTransform 131 

StretchBlt 131 

StretchDIBits 132 

StrokeAndFillPath 732 

StrokePath 132 

TabbedTextOut 132 

TextOut 133 

TextRect 133 

UpdateColors 134 

WidenPath 134 
TDecoratedFrame 

inheritance diagram 496 
TDecoratedFrame class 136 

constructor 136 

data members, protected 137 

macro 138 

member functions 
protected 137 
public 136 

response table 138 
TDecoratedMDIFrame 

inheritance diagram 497 
TDecoratedMDIFrame class 138 

constructor 138 

member functions, protected 138 

response table 139 
TDesktopDC 

constructor 139 
tdGetData 

TRange Validator enum 338 

TTransferDirection enum 394 
tdGetData constant 80, 236, 254, 357, 374 
TDialog 

inheritance diagram 499 
TDialog class 139 

constructor 140 

data members, public 140 

destructor 140 

member functions 
protected 143 
public 140 

response table 144 
TDialog Attr structure 144 
TDib 

constructors 146 

data members 
Bits 145 



H 145 

Info 145 

IsCore 145 

Mode 145 

NumClrs 146 

W 146 
destructor 147 
member functions 

Getlnfo 148 
TDib member functions 
ChangeModeToPal 147 
ChangeModeToRGB 147 
FindColor 147 
Findlndex 147 
GetBits 148 
GetColor 148 
GetColors 148 
Getlndex 148 
Getlndices 148 
GetlnfoHeader 148 
Height 148 
InfoFromHandle 151 
IsOk 148 
IsPM 149 
LoadFile 151 
LoadResource 151 
MapColor 149 
Maplndex 149 
numColors 149 
numScans 149 
operator BITMAPINFO() 149 
operator BITMAPINFOHEADER() 150 
operator HANDLE() 150 
operator TRgbQuad() 150 
Read 151 
SetColor 150 
Setlndex 150 
Size 150 
StartScan 150 
ToClipboard 750 
Usage 750 
Width 757 
WriteFile 757 
TDibDC 

constructor 151,152 
TDocManager 

inheritance diagram 500 
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TDocManager class constructor 153 
TDocManager class 152 
data members 

public 153 
macro 157 
member functions 

protected 156 

public 153 
response table 157 
TDocTemplate 

inheritance diagram 500 
TDocTemplate class 157 
constructor 160 
destructor 160 
member functions 

protected 160 

public 157 
templates, creating 20 
TDocTemplateT class 160 
member functions 

public 161 
TDocument x 

and closing files 192 
inheritance diagram 500 
TDocument: :List class 169 

constructor 169 
TDocument class 162 
constructor 163 
data members 

protected 168 

public 163 
destructor 163 
member functions 

protected 168 

public 164 
templates, creating 20 
TDropInfo 
class 169 
constructors 169 
TDropInfo member functions 
DragFinish 170 
DragQueryFile 1 70 
DragQueryFileCount 170 
DragQueryFileNameLen 170 
DragQuery Point 170 
operator HDROP() 171 



tdSetData 

TRange Validator enum 338 

TTransferDirection enum 394 
tdSetData constant 80, 236, 254, 357, 374 
tdSizeData 

TRange Validator enum 338 
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TApplication member function 39 
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TEventlnfo class 190 

data members, public 190 
TEventStatus enum 191 
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TTextGadget member function 382 
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editing 174 
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current position 177 
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interface element 373 
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TComboBox data member 76 

TStatic data member 373 
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inheritance diagram 508 
TFileOpenDialog class 195 

constructor 195 

member functions, public 195 
TFileSaveDialog 
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public 199 
TFindReplaceDialog::TData structure 199 

errors 199 
TFindReplaceDialog class 197 
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macros 202 
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data members 
StocksQ 202 
TStockld 202 
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HFONT() 203 
TFrame Window class 203 
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data members 
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public 204 
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member functions 
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public 204 
response table 208 
TGadgetWindow 

inheritance diagram 516 
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Handle 227 
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TGdiObject destructor 228 
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moving 356, 357 
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ThumbRect 

TSlider data member 372 
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TSlider data member 372 
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TSlider data member 372 
TIC 
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TSlider data member 372 
tick positions 
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TIcon 233 
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TToolBox member function 391 
tiling 265 
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timer event 433, 441 
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data members, public 235 

member functions 
protected 236 
public 236 
TInStream class 236 
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retrieving 431 

TPrintout data member 332 

TWindow data member 414 
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macros 239 

response table 239 
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constants 24 1 

data members, public 240 
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data members, protected 248 

destructor 247 

member functions 
protected 248 
public 247 

response table 248 
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inheritance diagram 520 
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constructors 248, 249 

member functions 
protected 254 
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public 263 

response table 266 
TMDIFrame 

inheritance diagram 523 
TMDIFrame class 267 

constructors 267 

data members, public 267 

member functions 
protected 268 
public 268 
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TMemoryDC 

constructor 269 
TMemoryDC member functions 

RestoreBitmap 269 

RestoreObjects 269 

SelectObject 270 
TMenu class 270 

constructors 270, 271 

data members, public 273 

destructor 271 

member functions, public 271 
TMenuDescr.-.TGroup enum 276 
TMenuDescr class 273 
TMetaFileDC 

constructor 277 

destructor 278 
TMetaFileDC member functions 

Close 278 
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class 278 

constructors 278 

destructor 279 



TMetaFilePict member functions 

GetMetaFileBits 280 

GetMetaFileBitsEx 280 

IsOK 280 

operator HMETAFILE() 280 
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TModule class 280 

constructors 281 

data members 
protected 287 
public 280 

destructor 281 

member functions, public 282 
ToClipboard 

TBitmap member function 43 

TDib member function 150 

TPalette member function 296 
Toggle 

TCheckBox member function 60 
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TPXPictureValidator member function 336 
toolbars 136 
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public 288 
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public 288 
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related operator 
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TPrintout class 330 

constructor 330 

data members, protected 332 

destructor 330 

member functions, public 330 
TPrintPreviewDC class 323 

constructor 324 

data members, protected 327 

member functions 
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TProcInstance class 333 

constructor 333 
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constants 334 

constructor 333 
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protected 335 
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TDecoratedFrame data member 737 
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TScroller data member 359 
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TRadioButton 
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response table 337 
TRange Validator class 337 

constructor 337 

data members, protected 338 

member functions, public 337 
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TCheckBox member function 60 

TComboBox member function 80 
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TSockld 

TPen data member 298 
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TButtonGadget data member 51 
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TStatic class 373 
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data members, public 373 

member functions 
protected 375 
public 374 
TStatus 
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TStatus class 
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TStatusBar data member 376 
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public 376 

member functions 
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TFont data member 202 
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TStream class 378 
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public destructor 378 
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destructor 379 

member functions, public 380 
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inheritance diagram 530 
TTileDirection enum 383 
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destructor 392 

member functions, public 392 
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constructor 396 

destructor 397 
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member functions, protected 407 

response tables 407 
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constructor 408 
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protected 410 
public 408 

destructor 408 

member functions 
protected 410 
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TWidthHeight enum 412 
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inheritance diagram 534 
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data members 
protected 445 
public 413 

destructors 415 
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member functions 
protected 446 
public 415 

member functions, defining 83, 84 

response table 447 
TWindowAttr 

TMDIClient class 263 
TWindowAttr structure 413, 449 

data members, public 449 

extended style constants 449 

style constants 450 

Tmenu resource ID 450 
TWindowDC 

constructors 450, 451 

destructors 450 
TWindowDC data members 

Wnd 451 
TWindowFlag enum 449 
TWindowView 

inheritance diagram 533 
TWindowView class 451 

constructors 451 

destructors 451 

member functions, public 451 
twips to pixels conversion 407 
TXCompatibility exception 281 

and TStatus 375 
TXInvalidMainWindow 

exception 38 
TXInvalidMainWindow constructor 39 
TXInvalidModule 

exception 284 
TXInvalidWindow 

and TEditView 256 
typographical conventions 2 

u 

UINT 

TMenu member function 272 
Uncheck 

TCheckBox member function 60 
Undo, TEdit member function 1 79 
Unhandled 

TXOwl public member function 455 
Units 

TLayoutConstraint data member 24 1 
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TPrintDialog::TData member function 323 
UnlockBuffer 

TEdit member function 1 79 
UnrealizeObj ect 

TBrush member function 48 

TPalette member function 297 
UnRefTemplate 

TDocManager member function 156 
UnregisterHotKey 

TWindow member function 444 
UnsetOption 

TValidator member function 394 
Update 

TControlGadget member function 89 
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windows 429 
update region 

windows 430 
UpdateColors 

TDC member function 134 
UpdateStatusBar 

TKeyboardModeTracker data member 238 
UpdateWindow 

TWindow member function 444 
Usage 

TDib member function 150 
user input 

checking 196, 260 
data entry 391 
input fields 379 
numeric values 337 
picture strings 333 
user input, retrieving 235 
user interface 

bitmaps 55 
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TValidator member function 394 
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picture formats 335 
Validate 

TWindow member function 444 
VALIDATE.CPP 391 
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ValidateRect 

TWindow member function 444 
ValidateRgn 

TWindow member function 444 
validating 

picture result type 300 

pictures 300 
validating edits 

and derived classes 179 
validating user input 196, 260 

data entry 391 

input fields 379 

numeric values 337 

picture strings 333 
Validator 

TEdit data member 1 79 
validator constants 455 
validators 

data transfer 338, 393 

filter 196 

IDs 

constants 25 

lookup 260 
string 379 

picture 333 

range 337 

validity testing 197, 380 
picture formats 334 
ValidChars 

TFilter Validator data member 197 
validity testing 393, 394 
ValidWindow 

TModule member function 287 
Value 

TColor data member 75 

TGauge data member 223 
Value constant 24 1 
values 

checking 393 
range of 337 

setting 197 
maximum/minimum 338 
VBX controls 

firing events 403 

receiving events 402 
VBX EVENTARGNUM 406 



VBXEVENT structure 

Control 404 

Eventlndex 404 

EventName 404 

ID 404 

lparam 404 

NumParams 404 

ParamList 404 

Window 404 
version numbers 

returning 30 
vertical scroll bars 354 
vertical scrollbar range value 

converting 362 
vertical sliders 411 
viewing 

current state, program 376, 377 
viewport 324, 325, 326 
views 

closing 20 

creating 20 

ID constants 25 

with no window 408 
virtual key codes 237 
VnCommit 

TEdit View member function 188 

TListView member function 259 
VnDocClosed 

TEdit View member function 188 

TListView member function 259 
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TEditView member function 188 

TListView member function 259 
VnlsWindow 

TEditView member function 189 

TListView member function 259 
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TEditView member function 189 

TListView member function 259 
Vnxxxx view notification constants 455 
Voxxxx validator constants 455 
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TScroller member function 361 
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TWindow Attr structure 450 
WaitingForSysCmd 

TTiny Caption data member 384 
warning beeps 180 
wf AutoCreate constant 417 
wfXxxx constants 417 
White 

TColor data member 73 
WideAsPossible 

TGadget data member 209 

TGadgetWindow data member 219 
WidenPath 

TDC member function 134 
Width 

TBitmap member function 43 

TDib member function 151 

TLayoutMetrics data member 242 

TRect member function 344 
Win32 

icons 2 
WIN32 DLLs 

exporting 29 

importing 29 
WIN API 

encapsulated functions 473 
Window 

TGadget data member 213 

TScroller data member 359 

TXWindow data member 448 
window classes 

returning information on 283 
window mapping functions 324, 325, 326 
windowev.h 

window messages 457 
WindowFromPoint 

TWindow member function 444 
WindowGroup 

TMenuDescr enum 276 
WindowProc 

TWindow member function 444 
Windows 

bitmaps, predefined 284 

combo box 
interface element 76 
types 76 

control interface elements 84 

control message 143 



CreateDialogPar am function 141 
CTL3D DLL support 139 
cursors, predefined 285 
default 

class name, modal dialog box 143 

message processing 413 
DialogBoxParam function 1 42 
edit control interface element 1 73 
EndDialog function 14 1 
handles, returning 286 
icons, predefined 285 
interface element 417 
list box interface element 248 
OPENFILENAME structure 195 
predefined class 207 
push button interface element 48 
radio button interface element 336 
redisplay 434 

registration class attributes 446 
registration class name 

"BUTTON" 50, 60, 232 

"EDIT" 181 

"LISTBOX" 254 

"MDICLIENT" 266 

"STATIC" 375 

class attributes and 435 

pure virtual function 446 
resources, loading into memory 286 
SB_ constants 360 
scroll bar messages 354 
static text interface element 373 
windows 

bit mask constants 449 

caption bars, creating 383 

cascading 264 

child 138, 141, 239, 241, 261, 263, 264 

client 136, 203 

Clipboard-viewer chain 

adding 70, 71 

removing 71 
closing 34, 264, 417 

dialog box 140, 142 
constraints 

defined 241 

edge 171,241,244 

layout 239, 241 
creating 14 1, 239, 412 
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main 31, 38 

decorating 136, 138 

default procedure 413 

default processing 139 

handles 

retrieving 68 

layout 349 

constraints 239, 241 
metrics, defining 24 1, 244 

main 267, 41 7 
status 28 1 

moving through 203, 358 

naming 39, 412, 414 

painting 207 

placing 171 

property list, retrieving handle for 428 

sizing269,349,412 

tiling 265 
WinHelp 

TWindow member function 445 
WM_CREATE message 450 
WMJNITDIALOG message 

TDialogAttr and 145 
WM_PAINT message 207, 434 
WMJTIMER messages 433, 441 
WMJ/BXFIREEVENT message 403 
Wnd 

TWindowDC data member 451 
word-break functions 7 79 
word wrapping 175, 177 
WParam 

control message parameter 143 
Write 

TEditFile member function 184 
WriteFile 

TDib member function 151 
WS_ window style constants 76, 84, 336, 374 
WS_BORDER constant 248 
WS_HSCROLL constant 354 
WS_TABSTOP style 231 
WS_VSCROLL constant 248, 354 
WS_xxxx window style constants 263 
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x 

TLayoutMetrics data member 242 

TWindow Attr structure 450 
XLine 

TScroller data member 359 
xmsg error 

TModule function 282 
XPage 

TScroller data member 359 
XPos 

TScroller data member 359 
XRange 

TScroller data member 359 
XRangeValue 

TScroller member function 361 
xs exception status bit flags 37 
xs exception status enum 456 
XScrollValue 

TScroller member function 361 
XUnit • 

TScroller data member 359 

Y 

Y 

TLayoutMetrics data member 242 

TWindowAttr structure 450 
YLine 

TScroller data member 359 
YPage 

TScroller data member 359 
YPos 

TScroller data member 359 
YRange 

TScroller data member 359 
YRangeValue 

TScroller member function 362 
YScrollValue 

TScroller member function 362 
YUnit 

TScroller data member 359 
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